@xlsft/grammy-reactive 0.7.34

package/dist/lib/render/message.render.js

@@ -0,0 +1,60 @@
+import { createFragmentElementRender } from "./node/fragmemt.render";
+import { InputMediaBuilder, InputFile } from "~/types/grammy.types";
+/**
+ * Renders a JSX message tree into a Telegram-compatible payload.
+ *
+ * This is the root render pipeline entry responsible for converting
+ * a resolved JSX tree into:
+ * - HTML text
+ * - Telegram send options
+ * - optional media attachments
+ * - resolved render view mode
+ *
+ * The renderer automatically enforces `parse_mode: "HTML"` and
+ * converts collected image attachments into Telegram photo media.
+ *
+ * If at least one media attachment is present, the resulting
+ * render view is resolved as `"caption"`. Otherwise, it is
+ * rendered as a plain `"message"`.
+ *
+ * The final text output is automatically trimmed to Telegram's character message limit.
+ * If view is `"message"`, the text is trimmed to 4096 characters.
+ * If view is `"caption"`, the text is trimmed to 1024 characters.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ * @param {RenderedMessageOptions<C, Other>} options - Root render options.
+ * @returns {RenderedMessage<Other>} The fully rendered Telegram payload.
+ *
+ * @example
+ * const result = await createMessageRender({
+ *     id,
+ *     method: "replyWithJSX",
+ *     jsx: <b>Hello</b>,
+ *     ctx,
+ *     other: {},
+ * });
+ */
+export async function createMessageRender(options) {
+    options.other ??= {};
+    options.other.parse_mode = "HTML";
+    const tree = await options.jsx;
+    let photo = undefined;
+    const media = [];
+    const [text, attachments] = await createFragmentElementRender(tree, options);
+    if (attachments?.length)
+        for (const item of attachments) {
+            media.push(InputMediaBuilder.photo(item.src, {
+                show_caption_above_media: item.position === 'top',
+                has_spoiler: item.spoiler
+            }));
+            photo = new InputFile(item.src);
+        }
+    return {
+        text: text.slice(0, media?.length ? 1024 : 4096),
+        other: options.other,
+        view: media?.length ? 'caption' : 'message',
+        media, photo
+    };
+}
+//# sourceMappingURL=message.render.js.map

package/dist/lib/render/message.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.render.js","sourceRoot":"","sources":["../../../src/lib/render/message.render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,OAAyC;IAEzC,OAAO,CAAC,KAAK,KAAK,EAAW,CAAC;IAAE,OAAO,CAAC,KAAa,CAAC,UAAU,GAAG,MAAM,CAAA;IACzE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;IAC/B,IAAI,KAAK,GAA0B,SAAS,CAAC;IAAC,MAAM,KAAK,GAAsB,EAAE,CAAC;IAElF,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7E,IAAI,WAAW,EAAE,MAAM;QAAE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,wBAAwB,EAAE,IAAI,CAAC,QAAQ,KAAK,KAAK;gBACjD,WAAW,EAAE,IAAI,CAAC,OAAO;aAC5B,CAAC,CAAC,CAAA;YACH,KAAK,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;IACD,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC3C,KAAK,EAAE,KAAK;KACf,CAAC;AACN,CAAC"}

package/dist/lib/render/node/fragmemt.render.d.ts

@@ -0,0 +1,34 @@
+import type { RenderedMessageOptions } from "src/types/lib.types";
+import type { JSX } from "src/types/jsx.types";
+import type { MaybeArray, ReactiveContext } from "~/types/plugin.types";
+import type { OtherContexted } from "~/types/grammy.types";
+/**
+ * Recursively renders a JSX fragment tree into Telegram-compatible HTML string output.
+ *
+ * This renderer walks the provided JSX subtree, concatenates rendered
+ * text output, delegates intrinsic node rendering, and bubbles collected
+ * media attachments upward through the render pipeline.
+ *
+ * Supported node handling:
+ * - plain text nodes
+ * - fragment recursion
+ * - intrinsic host node rendering
+ *
+ * Media extraction can optionally be suppressed for nested render
+ * branches when only text output is required.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ * @param {MaybeArray<JSX.Element>} elements - The JSX subtree to render.
+ * @param {RenderedMessageOptions<C, Other>} options - Active render context.
+ * @param {boolean} [noMedia]
+ * When `true`, extracted media is ignored for this render branch.
+ * @returns {Promise<[string, IntrinsicElements["img"][]] | [string]>}
+ * The rendered HTML text and optional bubbled media attachments.
+ */
+export declare function createFragmentElementRender<C extends ReactiveContext, Other extends OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">>(elements: MaybeArray<JSX.Element>, options: RenderedMessageOptions<C, Other>, noMedia?: boolean
+/** TODO:
+ * Uncomment this when caption rerender is fixed
+ * */
+): Promise<[string, any[]] | [string]>;
+//# sourceMappingURL=fragmemt.render.d.ts.map

package/dist/lib/render/node/fragmemt.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmemt.render.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/node/fragmemt.render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAqB,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAC7C,CAAC,SAAS,eAAe,EACzB,KAAK,SAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,EAE9E,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EACjC,OAAO,EAAE,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,EACzC,OAAO,CAAC,EAAE,OAAO;AACjB;;KAEK;GAEN,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CA2BrC"}

package/dist/lib/render/node/fragmemt.render.js

@@ -0,0 +1,56 @@
+import { createIntrinsicElementRender } from "./intrinsic.render";
+import { createPlainElementRender } from "./plain.render";
+/**
+ * Recursively renders a JSX fragment tree into Telegram-compatible HTML string output.
+ *
+ * This renderer walks the provided JSX subtree, concatenates rendered
+ * text output, delegates intrinsic node rendering, and bubbles collected
+ * media attachments upward through the render pipeline.
+ *
+ * Supported node handling:
+ * - plain text nodes
+ * - fragment recursion
+ * - intrinsic host node rendering
+ *
+ * Media extraction can optionally be suppressed for nested render
+ * branches when only text output is required.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ * @param {MaybeArray<JSX.Element>} elements - The JSX subtree to render.
+ * @param {RenderedMessageOptions<C, Other>} options - Active render context.
+ * @param {boolean} [noMedia]
+ * When `true`, extracted media is ignored for this render branch.
+ * @returns {Promise<[string, IntrinsicElements["img"][]] | [string]>}
+ * The rendered HTML text and optional bubbled media attachments.
+ */
+export async function createFragmentElementRender(elements, options, noMedia) {
+    const array = Array.isArray(elements) ? elements : [elements];
+    let out = "";
+    const media = [];
+    for (let i = 0; i < array.length; i++) {
+        const current = array[i];
+        if (current == null)
+            continue;
+        const element = await current, type = element.type;
+        if (type === "plain") {
+            out += createPlainElementRender(element);
+            continue;
+        }
+        const rendered = type === "fragment"
+            ? await createFragmentElementRender(element.children, options)
+            : await createIntrinsicElementRender(element, options);
+        out += rendered[0];
+        if (noMedia)
+            continue;
+        const _media = rendered[1];
+        if (_media)
+            for (let j = 0; j < _media.length; j++) {
+                const item = _media[j];
+                if (item)
+                    media.push(item);
+            }
+    }
+    return [out, media];
+}
+//# sourceMappingURL=fragmemt.render.js.map

package/dist/lib/render/node/fragmemt.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmemt.render.js","sourceRoot":"","sources":["../../../../src/lib/render/node/fragmemt.render.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAI7C,QAAiC,EACjC,OAAyC,EACzC,OAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,IAAI,GAAG,GAAG,EAAE,CAAC;IAAC,MAAM,KAAK,GAA+B,EAAE,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAAC,IAAI,OAAO,IAAI,IAAI;YAAE,SAAS;QACxD,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAEnD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAAC,GAAG,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,KAAK,UAAU;YAChC,CAAC,CAAC,MAAM,2BAA2B,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;YAC9D,CAAC,CAAC,MAAM,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE3D,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,OAAO;YAAE,SAAQ;QACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,MAAM;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/lib/render/node/intrinsic.render.d.ts

@@ -0,0 +1,37 @@
+import type { IntrinsicElement } from "src/types/jsx.types";
+import type { ReactiveContext } from "~/types/plugin.types";
+import type { RenderedMessageOptions } from "src/types/lib.types";
+import type { OtherContexted } from "src/types/grammy.types";
+/**
+ * Renders a single intrinsic JSX node into its Telegram-compatible HTML string output.
+ *
+ * This is the host renderer responsible for translating framework
+ * intrinsic elements into Telegram HTML, media attachments, preview
+ * metadata, and interactive reply markup mutations.
+ *
+ * Supported responsibilities include:
+ * - Telegram HTML tag rendering
+ * - media attachment extraction
+ * - link preview configuration
+ * - inline keyboard construction
+ * - callback button registration
+ * - intrinsic runtime validation
+ *
+ * Some intrinsic elements mutate the provided render options directly,
+ * such as:
+ * - `reply_markup`
+ * - `link_preview_options`
+ * - callback registry bindings
+ *
+ * Unsupported elements for the current render method are rejected
+ * through runtime JSX parse errors.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ * @param {IntrinsicElement} element - The intrinsic node to render.
+ * @param {RenderedMessageOptions<C, Other>} options - Active render context.
+ * @returns {Promise<[string, IntrinsicElements["img"][]] | [string]>}
+ * The rendered HTML fragment and optional extracted media.
+ */
+export declare function createIntrinsicElementRender<C extends ReactiveContext, Other extends OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">>(element: IntrinsicElement, options: RenderedMessageOptions<C, Other>): Promise<[string, (any[])] | [string]>;
+//# sourceMappingURL=intrinsic.render.d.ts.map

package/dist/lib/render/node/intrinsic.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intrinsic.render.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/node/intrinsic.render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA0B,gBAAgB,EAAmC,MAAM,qBAAqB,CAAC;AACrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,SAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,EACxJ,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,GAC1C,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAyHvC"}

package/dist/lib/render/node/intrinsic.render.js

@@ -0,0 +1,167 @@
+import { InlineKeyboard, InputMediaBuilder, Keyboard } from "src/types/grammy.types";
+import { createFragmentElementRender } from "./fragmemt.render";
+import { generateUniqueId, isEmoji, isUnixTime } from "src/utils";
+import { createTagRender as t } from "../tag.render";
+import { getEmoji, getPlainText, globalButtonCallbacks } from "src/utils";
+import { JSXParseError } from "src/jsx/runtime/jsx.errors";
+/**
+ * Renders a single intrinsic JSX node into its Telegram-compatible HTML string output.
+ *
+ * This is the host renderer responsible for translating framework
+ * intrinsic elements into Telegram HTML, media attachments, preview
+ * metadata, and interactive reply markup mutations.
+ *
+ * Supported responsibilities include:
+ * - Telegram HTML tag rendering
+ * - media attachment extraction
+ * - link preview configuration
+ * - inline keyboard construction
+ * - callback button registration
+ * - intrinsic runtime validation
+ *
+ * Some intrinsic elements mutate the provided render options directly,
+ * such as:
+ * - `reply_markup`
+ * - `link_preview_options`
+ * - callback registry bindings
+ *
+ * Unsupported elements for the current render method are rejected
+ * through runtime JSX parse errors.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ * @param {IntrinsicElement} element - The intrinsic node to render.
+ * @param {RenderedMessageOptions<C, Other>} options - Active render context.
+ * @returns {Promise<[string, IntrinsicElements["img"][]] | [string]>}
+ * The rendered HTML fragment and optional extracted media.
+ */
+export async function createIntrinsicElementRender(element, options) {
+    const media = [];
+    if (options.unallowed && options.unallowed.includes(element.entity.type)) {
+        throw new JSXParseError(`Elements: ${options.unallowed.join(', ')} is not allowed in "${options.method}" method`);
+    }
+    switch (element.entity.type) {
+        case "br": return ['\n'];
+        case 'p': return [`${(await createFragmentElementRender(element.children, options, true))[0]}\n`];
+        case 'b': return [
+            t('b', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'i': return [
+            t('i', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'u': return [
+            t('u', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 's': return [
+            t('s', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'h': return [
+            t('b', (await createFragmentElementRender(element.children, options, true))[0]) + '\n'
+        ];
+        case 'a': return [
+            t('a', (await createFragmentElementRender(element.children, options, true))[0], {
+                href: encodeURI(element.entity.href)
+            })
+        ];
+        case 'blockquote': return [
+            t('blockquote', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'code': return [
+            t('code', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'codeblock': return [element.entity.lang ?
+                t('pre', t('code', (await createFragmentElementRender(element.children, options, true))[0], {
+                    class: `language-${element.entity.lang}`
+                })) : t('pre', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'spoiler': return [
+            t('tg-spoiler', (await createFragmentElementRender(element.children, options, true))[0])
+        ];
+        case 'emoji': {
+            const alt = element.children.find(v => v.type === 'plain').value || '👍';
+            if (!isEmoji(alt))
+                throw new JSXParseError(`Emoji alt property is not a valid emoji: ${alt}`);
+            return [
+                t('tg-emoji', alt, { "emoji-id": element.entity.id })
+            ];
+        }
+        case 'time': {
+            if (!isUnixTime(element.entity.unix))
+                throw new JSXParseError(`Time property is not a valid unix timestamp: ${element.entity.unix}`);
+            return [
+                t('tg-time', (await createFragmentElementRender(element.children, options, true))[0], {
+                    unix: element.entity.unix,
+                    format: element.entity.format
+                })
+            ];
+        }
+        case "img": {
+            media.push(element.entity);
+            return ['', media];
+        }
+        case "preview": {
+            if (options.other.link_preview_options)
+                throw new JSXParseError("Preview in this state are already set");
+            options.other.link_preview_options = {
+                is_disabled: false,
+                url: element.entity.src,
+                show_above_text: element.entity.position !== 'bottom',
+                ...(element.entity.size === 'small' ? { prefer_small_media: true } : { prefer_large_media: true }),
+            };
+            return [
+                t('a', '\u00A0', { href: encodeURI(element.entity.src) })
+            ];
+        }
+        case "button": {
+            if (options.other.reply_markup instanceof Keyboard)
+                throw new JSXParseError("Inline keyboard cannot be used with custom keyboards");
+            if (!options.other.reply_markup)
+                options.other.reply_markup = new InlineKeyboard();
+            const entity = element.entity;
+            const id = `::${options.id}::${entity.event || element.id || generateUniqueId()}`;
+            const keyboard = options.other.reply_markup;
+            const emoji = getEmoji(element);
+            if (emoji)
+                keyboard.icon(emoji.id);
+            const text = getPlainText(element);
+            if (!text)
+                throw new JSXParseError("Inline button must have a text child");
+            switch (entity.variant) {
+                case 'url':
+                    keyboard.url(text, entity.url);
+                    break;
+                case 'callback':
+                    keyboard.text(text, id);
+                    break;
+                case 'login':
+                    keyboard.login(text, entity.data);
+                    break;
+                case 'switch_inline':
+                    keyboard.switchInline(text, entity.query);
+                    break;
+                case 'switch_inline_chosen':
+                    keyboard.switchInlineChosen(text, entity.data);
+                    break;
+                case 'copy':
+                    keyboard.copyText(text, entity.value.slice(0, 255));
+                    break;
+                case 'game':
+                    keyboard.game(text);
+                    break;
+                case 'pay':
+                    keyboard.pay(text);
+                    break;
+                default: throw new Error(`Unknown button variant: ${entity.variant}`);
+            }
+            if (entity.color)
+                keyboard.style(entity.color);
+            if (entity.row)
+                keyboard.row();
+            if (entity.variant === 'callback' && entity.onClick)
+                globalButtonCallbacks[id] = entity.onClick;
+            return [''];
+        }
+        default: return ['', media];
+    }
+}
+//# sourceMappingURL=intrinsic.render.js.map

package/dist/lib/render/node/intrinsic.render.js.map

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

package/dist/lib/render/node/plain.render.d.ts

@@ -0,0 +1,27 @@
+import type { PlainElement } from "~/types/jsx.types";
+/**
+ * Renders a {@link PlainElement} into a sanitized HTML-safe string.
+ *
+ * This function serializes plain text render nodes during the final
+ * render phase of the message AST pipeline.
+ *
+ * Supported value handling:
+ * - `null`, `undefined`, and boolean values render as an empty string
+ * - `string` values are HTML-sanitized directly
+ * - numeric values are stringified before sanitization
+ *
+ * The resulting string is always safe to embed into Telegram HTML output.
+ *
+ * @param {PlainElement} element - The plain text node to render.
+ * @returns {string} The sanitized rendered string.
+ *
+ * @example
+ * plainElementRender({ type: "plain", value: "Hello <world>" });
+ * // "Hello &lt;world&gt;"
+ *
+ * @example
+ * plainElementRender({ type: "plain", value: 42 });
+ * // "42"
+ */
+export declare function createPlainElementRender(element: PlainElement): string;
+//# sourceMappingURL=plain.render.d.ts.map

package/dist/lib/render/node/plain.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.render.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/node/plain.render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAItE"}

package/dist/lib/render/node/plain.render.js

@@ -0,0 +1,32 @@
+import { sanitizeHtmlString } from "~/utils";
+/**
+ * Renders a {@link PlainElement} into a sanitized HTML-safe string.
+ *
+ * This function serializes plain text render nodes during the final
+ * render phase of the message AST pipeline.
+ *
+ * Supported value handling:
+ * - `null`, `undefined`, and boolean values render as an empty string
+ * - `string` values are HTML-sanitized directly
+ * - numeric values are stringified before sanitization
+ *
+ * The resulting string is always safe to embed into Telegram HTML output.
+ *
+ * @param {PlainElement} element - The plain text node to render.
+ * @returns {string} The sanitized rendered string.
+ *
+ * @example
+ * plainElementRender({ type: "plain", value: "Hello <world>" });
+ * // "Hello &lt;world&gt;"
+ *
+ * @example
+ * plainElementRender({ type: "plain", value: 42 });
+ * // "42"
+ */
+export function createPlainElementRender(element) {
+    const value = element.value;
+    if (value == null || value === false || value === true)
+        return "";
+    return typeof value === "string" ? sanitizeHtmlString(value) : sanitizeHtmlString("" + value);
+}
+//# sourceMappingURL=plain.render.js.map

package/dist/lib/render/node/plain.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.render.js","sourceRoot":"","sources":["../../../../src/lib/render/node/plain.render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAqB;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAClE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;AAClG,CAAC"}

package/dist/lib/render/tag.render.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Wraps pre-rendered child content in an intrinsic HTML tag pair.
+ *
+ * This is a low-level render helper used during the final serialization
+ * phase to convert intrinsic text entities into Telegram-compatible
+ * HTML markup.
+ *
+ * The function assumes that `children` has already been fully rendered
+ * and sanitized by the caller.
+ *
+ * @param {string} tag - The tag name to render.
+ * @param {string} children - Pre-rendered child HTML content.
+ * @returns {string} The serialized HTML tag string.
+ *
+ * @example
+ * createTagElementRender("b", "Hello");
+ * // "<b>Hello</b>"
+ *
+ * @example
+ * createTagElementRender("code", "&lt;div&gt;");
+ * // "<code>&lt;div&gt;</code>"
+ */
+export declare function createTagRender(tag: string, children: string, attributes?: Record<string, any>): string;
+//# sourceMappingURL=tag.render.d.ts.map

package/dist/lib/render/tag.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.render.d.ts","sourceRoot":"","sources":["../../../src/lib/render/tag.render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM,CAG3G"}

package/dist/lib/render/tag.render.js

@@ -0,0 +1,27 @@
+/**
+ * Wraps pre-rendered child content in an intrinsic HTML tag pair.
+ *
+ * This is a low-level render helper used during the final serialization
+ * phase to convert intrinsic text entities into Telegram-compatible
+ * HTML markup.
+ *
+ * The function assumes that `children` has already been fully rendered
+ * and sanitized by the caller.
+ *
+ * @param {string} tag - The tag name to render.
+ * @param {string} children - Pre-rendered child HTML content.
+ * @returns {string} The serialized HTML tag string.
+ *
+ * @example
+ * createTagElementRender("b", "Hello");
+ * // "<b>Hello</b>"
+ *
+ * @example
+ * createTagElementRender("code", "&lt;div&gt;");
+ * // "<code>&lt;div&gt;</code>"
+ */
+export function createTagRender(tag, children, attributes = {}) {
+    const result = `<${tag}${Object.entries(attributes).filter(Boolean).map(([k, v]) => ` ${k}="${v}"`).join('')}>${children}</${tag}>`;
+    return result;
+}
+//# sourceMappingURL=tag.render.js.map

package/dist/lib/render/tag.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.render.js","sourceRoot":"","sources":["../../../src/lib/render/tag.render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,QAAgB,EAAE,aAAkC,EAAE;IAC/F,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,GAAG,GAAG,CAAA;IACnI,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/lib/state/create.state.d.ts

@@ -0,0 +1,8 @@
+import type { BotHandlerLifecycleInstance, BotMessageHandler } from "~/types/lib.types";
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare function createMessageState<C extends ReactiveContext>({ id, ctx, handler }: {
+    id: string;
+    ctx: C;
+    handler: BotMessageHandler<C>;
+}): BotHandlerLifecycleInstance<C>;
+//# sourceMappingURL=create.state.d.ts.map

package/dist/lib/state/create.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.state.d.ts","sourceRoot":"","sources":["../../../src/lib/state/create.state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAO5D,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CACjC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CA0FjC"}

package/dist/lib/state/create.state.js

@@ -0,0 +1,61 @@
+import { createRerenderMessageState } from "./lifecycle/rerender.state";
+import { createUnmountMessageState } from "./lifecycle/unmount.state";
+import { globalAbortControllers } from "~/utils";
+import { createMountMessageState } from "./lifecycle/mount.state";
+import { createHooks } from "./hooks/create.hooks";
+/**
+ * Creates a lifecycle state controller for a mounted message session.
+ *
+ * The returned lifecycle instance provides bound `rerender` and
+ * `unmount` controls for the specified message render session.
+ *
+ * Each lifecycle action recreates a fresh state controller instance
+ * before delegating to the corresponding lifecycle transition,
+ * ensuring isolated rerender and cleanup flows.
+ *
+ * Used as the core runtime state bridge for both static and
+ * reactive message handlers.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {BotStaticMessageHandler<C> | BotMessageHandler<C>} handler
+ * The original handler bound to the lifecycle session.
+ * @returns {BotHandlerLifecycleInstance<C>}
+ * A lifecycle controller with `rerender` and `unmount` methods.
+ *
+ * @example
+ * const state = createMessageState(id, ctx, handler);
+ * await state.rerender();
+ */
+export function createMessageState({ id, ctx, handler }) {
+    return {
+        get controller() {
+            if (!globalAbortControllers.has(id))
+                globalAbortControllers.set(id, new AbortController());
+            return globalAbortControllers.get(id);
+        },
+        set controller(value) {
+            globalAbortControllers.set(id, value);
+        },
+        async mount() {
+            const state = createMessageState({ id, ctx, handler });
+            const hooks = createHooks({ id, ctx, handler, state, controller: this.controller });
+            await createMountMessageState({ id, ctx, handler, state, hooks });
+        },
+        async rerender() {
+            this.controller?.abort();
+            this.controller = new AbortController();
+            const state = createMessageState({ id, ctx, handler });
+            const hooks = createHooks({ id, ctx, handler, state, controller: this.controller });
+            await createRerenderMessageState({ id, ctx, handler, state, hooks, controller: this.controller });
+        },
+        async unmount() {
+            this.controller?.abort();
+            this.controller = new AbortController();
+            const state = createMessageState({ id, ctx, handler });
+            await createUnmountMessageState({ id, ctx, controller: this.controller });
+        }
+    };
+}
+//# sourceMappingURL=create.state.js.map

package/dist/lib/state/create.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.state.js","sourceRoot":"","sources":["../../../src/lib/state/create.state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,kBAAkB,CAA4B,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAI/E;IACG,OAAO;QACH,IAAI,UAAU;YACV,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,eAAe,EAAE,CAAC,CAAC;YAC3F,OAAO,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAC3C,CAAC;QACD,IAAI,UAAU,CAAC,KAAsB;YACjC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,KAAK;YACP,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;YACtD,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAG,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;YACpF,MAAM,uBAAuB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACrE,CAAC;QACD,KAAK,CAAC,QAAQ;YACV,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACjE,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;YACtD,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAG,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;YACpF,MAAM,0BAA0B,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;QACrG,CAAC;QACD,KAAK,CAAC,OAAO;YACT,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACjE,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;YACtD,MAAM,yBAAyB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/lib/state/events/onclick.event.d.ts

@@ -0,0 +1,21 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+import type { NextFunction } from "~/types/grammy.types";
+/**
+ * Dispatches registered reactive button callbacks for callback queries.
+ *
+ * This internal middleware resolves callback payloads against the
+ * button callback registry and executes the matching handler within
+ * its owning lifecycle session.
+ *
+ * If no registered callback exists, middleware control is delegated
+ * directly to the next handler.
+ *
+ * On handler failure, the owning lifecycle session is transitioned
+ * into its error fallback state.
+ *
+ * @param {ReactiveContext} ctx - The reactive Telegram context.
+ * @param {NextFunction} next - The next middleware in the pipeline.
+ * @returns {Promise<void>}
+ */
+export declare function createOnClickEvent(ctx: ReactiveContext, next: NextFunction): Promise<void>;
+//# sourceMappingURL=onclick.event.d.ts.map

package/dist/lib/state/events/onclick.event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onclick.event.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/events/onclick.event.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAehG"}