@xlsft/grammy-reactive 0.7.34

package/dist/lib/state/lifecycle/rerender.state.js

@@ -0,0 +1,86 @@
+import { globalCurrentState, globalPreviousState, isEqual } from "~/utils";
+import { createMessageRender } from "~/lib/render/message.render";
+import { createErrorMessageState } from "./error.state";
+/**
+ * Executes the rerender lifecycle transition for an active message session.
+ *
+ * This lifecycle step re-runs the original handler, re-renders the JSX tree,
+ * computes the next Telegram message payload, and applies the minimal
+ * required update strategy based on the selected render view.
+ *
+ * Supported rerender flows:
+ * - text message updates via `editMessageText`
+ * - caption updates via `editMessageCaption`
+ * - single media replacement via `editMessageMedia`
+ * - media group remount when multiple media items are present
+ *
+ * If the session is no longer mounted, the operation exits silently.
+ *
+ * After a successful update, the current message snapshot is promoted
+ * into the previous render state cache for future diff comparisons.
+ *
+ * Any runtime errors during rerendering are delegated to the lifecycle
+ * error handler before being logged.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique mounted message session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {BotStaticMessageHandler<C> | BotMessageHandler<C>} handler
+ * The original handler used to regenerate the render tree.
+ * @param {BotHandlerLifecycleInstance<C>} state
+ * The bound lifecycle controller instance.
+ * @param {ReturnType<typeof createHooks<C>>} [hooks]
+ * Optional reactive hook bindings for stateful handlers.
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await createRerenderMessageState(id, ctx, handler, state, hooks);
+ */
+export async function createRerenderMessageState({ id, ctx, handler, state, hooks, controller }) {
+    try {
+        if (!globalCurrentState[id])
+            return;
+        const element = await handler({ ctx, ...state, ...hooks || {} });
+        const data = await createMessageRender({
+            id,
+            method: createRerenderMessageState.name,
+            jsx: element,
+            ctx,
+            other: {},
+        });
+        if (data.view === 'message') {
+            if (globalPreviousState[id]?.text !== data.text) {
+                await ctx.api.editMessageText(globalCurrentState[id].chat.id, globalCurrentState[id].message_id, data.text, data.other, controller?.signal);
+            }
+        }
+        else if (data.view === 'caption') {
+            if (globalPreviousState[id]?.caption !== data.text)
+                await ctx.api.editMessageCaption(globalCurrentState[id].chat.id, globalCurrentState[id].message_id, data.other, controller?.signal);
+            if (data.media.length > 2) {
+                ctx.deleteMessage(controller?.signal);
+                const messages = await ctx.replyWithMediaGroup(data.media.slice(0, 10), data.other, controller?.signal);
+                if (!messages || !messages[0])
+                    throw new Error("Failed to send media group");
+                globalCurrentState[id] = messages[0];
+            }
+            else if (data.media.length === 1) {
+                if (!data.media[0])
+                    throw new Error("No photo provided for caption view");
+                const message = await ctx.api.editMessageMedia(globalCurrentState[id].chat.id, globalCurrentState[id].message_id, data.media[0], data.other, controller?.signal);
+                if (!message)
+                    throw new Error("Failed to send photo");
+                globalCurrentState[id] = message;
+            }
+            else
+                throw new TypeError("No media provided for caption view");
+        }
+        if (!globalCurrentState[id])
+            throw new Error("No state rendered");
+        globalPreviousState[id] = globalCurrentState[id];
+    }
+    catch (e) {
+        await createErrorMessageState(id, ctx, e);
+        console.error(e);
+    }
+}
+//# sourceMappingURL=rerender.state.js.map

package/dist/lib/state/lifecycle/rerender.state.js.map

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

package/dist/lib/state/lifecycle/unmount.state.d.ts

@@ -0,0 +1,9 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+import type { BotHandlerLifecycleInstance } from "~/types/lib.types";
+export declare function createUnmountMessageState<C extends ReactiveContext>({ id, ctx, controller, state }: {
+    id: string;
+    ctx: C;
+    controller: AbortController;
+    state: BotHandlerLifecycleInstance<C>;
+}): Promise<void>;
+//# sourceMappingURL=unmount.state.d.ts.map

package/dist/lib/state/lifecycle/unmount.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmount.state.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/unmount.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAKrE,wBAAsB,yBAAyB,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;IACvG,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,UAAU,EAAE,eAAe,CAAA;IAC3B,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAA;CACxC,iBAcA"}

package/dist/lib/state/lifecycle/unmount.state.js

@@ -0,0 +1,33 @@
+import { globalCurrentState } from "~/utils";
+import { createErrorMessageState } from "./error.state";
+/**
+ * Executes the unmount lifecycle transition for a mounted message session.
+ *
+ * If an active lifecycle state exists for the provided session ID,
+ * the currently bound Telegram message is deleted from chat.
+ *
+ * If the session is not mounted, the operation exits silently.
+ *
+ * Any runtime errors during deletion are forwarded to the lifecycle
+ * error handler before being logged to the console.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique mounted message session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await createUnmountMessageState(id, ctx);
+ */
+export async function createUnmountMessageState({ id, ctx, controller }) {
+    try {
+        if (!globalCurrentState[id])
+            return;
+        await ctx.deleteMessage();
+    }
+    catch (e) {
+        await createErrorMessageState(id, ctx, e);
+        console.error(e);
+    }
+}
+//# sourceMappingURL=unmount.state.js.map

package/dist/lib/state/lifecycle/unmount.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmount.state.js","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/unmount.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAGvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAA4B,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAI/F;IACG,IAAI,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAAE,OAAM;QACnC,MAAM,GAAG,CAAC,aAAa,EAAE,CAAA;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAU,CAAC,CAAA;QAClD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;AACL,CAAC"}

package/dist/types/grammy.types.d.ts

@@ -0,0 +1,29 @@
+import { InputFile, Keyboard, InlineKeyboard, InputMediaBuilder, Bot } from "grammy";
+import type { Context, MiddlewareFn, RawApi, NextFunction } from "grammy";
+import type { Message, MessageEntity, Update, InputMediaPhoto, InlineKeyboardButton } from "grammy/types";
+import type { Other } from "node_modules/grammy/out/core/api.d.ts";
+import type { Methods } from "node_modules/grammy/out/core/client.d.ts";
+/**
+ * A convenience alias for Grammy's {@link Other} utility type,
+ * specialized for context-bound API helper methods.
+ *
+ * This type is commonly used to describe additional Telegram method options
+ * while excluding parameters that are already handled internally by
+ * context-aware helpers such as `replyWithJSX()` or `editMessageJSX()`.
+ *
+ * It is especially useful for plugin APIs that wrap standard Grammy
+ * context methods and need strongly typed `other` options.
+ *
+ * @template {Methods<RawApi>} M - The target Grammy API method name.
+ * @template {string} [X=never] - Keys to exclude from the resulting options type.
+ *
+ * @example
+ * type ReplyOptions = OtherContexted<
+ *     "sendMessage",
+ *     "text" | "chat_id" | "parse_mode"
+ * >;
+ */
+type OtherContexted<M extends Methods<RawApi>, X extends string = never> = Other<RawApi, M, X>;
+export type { Context, MiddlewareFn, RawApi, NextFunction, Message, MessageEntity, Update, InputMediaPhoto, InlineKeyboardButton, Other, Methods, OtherContexted, };
+export { InputFile, Keyboard, InlineKeyboard, InputMediaBuilder, Bot };
+//# sourceMappingURL=grammy.types.d.ts.map

package/dist/types/grammy.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammy.types.d.ts","sourceRoot":"","sources":["../../src/types/grammy.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,QAAQ,EACR,cAAc,EACd,iBAAiB,EAEjB,GAAG,EACN,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EACR,OAAO,EACP,YAAY,EACZ,MAAM,EACN,YAAY,EACf,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EACR,OAAO,EACP,aAAa,EACb,MAAM,EACN,eAAe,EACf,oBAAoB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,KAAK,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/F,YAAY,EACR,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,oBAAoB,EACrE,KAAK,EAAE,OAAO,EAAE,cAAc,GACjC,CAAA;AACD,OAAO,EACH,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,EAC9D,CAAA"}

package/dist/types/grammy.types.js

@@ -0,0 +1,3 @@
+import { InputFile, Keyboard, InlineKeyboard, InputMediaBuilder, Bot } from "grammy";
+export { InputFile, Keyboard, InlineKeyboard, InputMediaBuilder, Bot };
+//# sourceMappingURL=grammy.types.js.map

package/dist/types/grammy.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammy.types.js","sourceRoot":"","sources":["../../src/types/grammy.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,GAAG,EACN,MAAM,QAAQ,CAAC;AA6ChB,OAAO,EACH,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,EAC9D,CAAA"}

package/dist/types/hooks.types.d.ts

@@ -0,0 +1,27 @@
+import type { BotHandlerLifecycleInstance } from "./lib.types";
+import type { ReactiveContext } from "./plugin.types";
+export type HookRuntime = {
+    id: string;
+    ctx: ReactiveContext;
+    state: BotHandlerLifecycleInstance<ReactiveContext>;
+    hooks: Map<string, unknown[]>;
+    componentPath: number[];
+    childCursorStack: number[];
+    hookCursor: number;
+    effects: Array<() => Promise<void>>;
+    visited: Set<string>;
+    renderVersion: number;
+    isRendering: boolean;
+    pendingRender: boolean;
+};
+export type MemoHook<T> = {
+    value: T;
+    deps?: unknown[];
+};
+export type ReducerHook<S, A> = (state: S, action: A) => S;
+export type EffectState = {
+    deps?: unknown[];
+    cleanup?: EffectCleanup;
+};
+export type EffectCleanup = void | (() => void | Promise<void>);
+//# sourceMappingURL=hooks.types.d.ts.map

package/dist/types/hooks.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.types.d.ts","sourceRoot":"","sources":["../../src/types/hooks.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,eAAe,CAAA;IACpB,KAAK,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAA;IACnD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACtB,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/types/jsx.types.d.ts

@@ -0,0 +1,240 @@
+import type { InlineKeyboardButton } from "grammy/types";
+import type { InlineKeyboard, Context } from "grammy";
+import type { ReactiveContextFlavor } from "~/types/plugin.types";
+import type { JSX } from "~/jsx/runtime/jsx.runtime";
+/**
+ * Adds optional JSX children support to a props object.
+ *
+ * This is the base utility used for intrinsic elements and custom
+ * component props that may receive renderable child nodes.
+ *
+ * @template P
+ */
+export type WithChildren<P = {}> = P & {
+    children?: Node;
+};
+/**
+ * Extracts the props type from a {@link WithChildren}-compatible shape.
+ *
+ * If the target type does not use `WithChildren`, the original type
+ * is returned unchanged.
+ *
+ * @template T
+ */
+export type PropsOf<T> = T extends WithChildren<infer P> ? P : T;
+/**
+ * Runtime registry of all supported intrinsic JSX elements.
+ *
+ * This object defines the canonical intrinsic tag surface supported by
+ * the Telegram JSX renderer.
+ *
+ * Use {@link IntrinsicElements} for the inferred type-safe version.
+ */
+export declare const intrinsicElements: {
+    b: WithChildren;
+    i: WithChildren;
+    u: WithChildren;
+    s: WithChildren;
+    spoiler: WithChildren;
+    a: WithChildren<{
+        href: string;
+    }>;
+    emoji: WithChildren<{
+        id: string;
+    }>;
+    time: WithChildren<{
+        unix: number;
+        format?: TimeFormat;
+    }>;
+    code: WithChildren;
+    codeblock: WithChildren<{
+        lang?: CodeBlockLanguages;
+    }>;
+    blockquote: WithChildren<{
+        expandable?: boolean;
+    }>;
+    h: WithChildren;
+    p: WithChildren;
+    br: {};
+    /** TODO:
+     * When caption rerender is fixed, uncomment this
+     * */
+    preview: {
+        src: string;
+        position?: "top" | "bottom";
+        size?: "small" | "large";
+    };
+    button: WithChildren<InlineButtonProps>;
+    mention: WithChildren<{
+        id: number;
+    }>;
+};
+/**
+ * Type-safe map of all supported intrinsic JSX elements and their props.
+ *
+ * Each key represents an intrinsic JSX tag name and each value
+ * defines its allowed props shape.
+ */
+export type IntrinsicElements = typeof intrinsicElements;
+/**
+ * Resolves the exact props type for a specific intrinsic element tag.
+ *
+ * @template {keyof IntrinsicElements} K
+ */
+export type ExactIntrinsicElement<K extends keyof IntrinsicElements> = IntrinsicElements[K];
+/**
+ * Union type describing all valid intrinsic element creation payloads.
+ *
+ * Each variant binds a `tag` to its corresponding strongly typed `props`.
+ */
+export type IntrinsicElementOptions = {
+    [K in keyof IntrinsicElements]: {
+        tag: K;
+        props: IntrinsicElements[K];
+    };
+}[keyof IntrinsicElements];
+/**
+ * Union type describing all supported inline keyboard button variants.
+ *
+ * Includes shared button styling options and variant-specific payloads.
+ */
+export type InlineButtonProps = {
+    [K in keyof InlineButtonPropsMap]: {
+        variant?: K;
+        color?: Parameters<typeof InlineKeyboard.prototype.style>[0];
+        row?: boolean;
+    } & InlineButtonPropsMap[K];
+}[keyof InlineButtonPropsMap];
+/**
+ * Resolves the exact payload type for a specific inline button variant.
+ *
+ * @template {keyof InlineButtonPropsMap} K
+ */
+export type ExactInlineButtonProps<K extends keyof InlineButtonPropsMap> = InlineButtonPropsMap[K];
+/**
+ * Mapping of supported inline keyboard button variants to their payload shapes.
+ *
+ * Used internally for variant-safe button entity creation.
+ */
+export type InlineButtonPropsMap = {
+    url: {
+        url: string;
+    };
+    callback: {
+        event?: string;
+        onClick?: (ctx: ReactiveContextFlavor<Context>) => Promise<void> | void;
+    };
+    app: {
+        url: string;
+    };
+    login: {
+        data: InlineKeyboardButton.LoginButton['login_url'];
+    };
+    switch_inline: {
+        query: string;
+    };
+    switch_inline_current: {
+        query: string;
+    };
+    switch_inline_chosen: {
+        data: InlineKeyboardButton.SwitchInlineChosenChatButton['switch_inline_query_chosen_chat'];
+    };
+    copy: {
+        value: string;
+    };
+    game: {};
+    pay: {};
+};
+/**
+ * Factory output map for intrinsic entity creation.
+ *
+ * Each intrinsic tag is mapped to its exact serialized entity shape.
+ */
+export type EntityFactoryMap = {
+    [K in keyof IntrinsicElements]: {
+        type: K;
+    } & EntityPropsMap[K];
+};
+/**
+ * Maps intrinsic element tags to their extracted serializable props.
+ */
+export type EntityPropsMap = {
+    [K in keyof IntrinsicElements]: Extract<PropsOf<IntrinsicElements[K]>, object>;
+};
+/**
+ * Internal entity lookup map keyed by intrinsic tag name.
+ */
+export type EntityMap = {
+    [K in keyof IntrinsicElements]: EntityBase<K> & (keyof PropsOf<IntrinsicElements[K]> extends never ? {} : PropsOf<IntrinsicElements[K]>);
+};
+/**
+ * Base discriminated entity shape.
+ *
+ * @template {string} K
+ */
+export type EntityBase<K extends string> = {
+    type: K;
+};
+/**
+ * Union type of all supported intrinsic render entities.
+ *
+ * This is the primary metadata representation used by intrinsic
+ * JSX tree nodes.
+ */
+export type Entity = {
+    [K in keyof IntrinsicElements]: keyof PropsOf<IntrinsicElements[K]> extends never ? EntityBase<K> : EntityBase<K> & PropsOf<IntrinsicElements[K]>;
+}[keyof IntrinsicElements];
+/**
+ * Primitive node values supported by the JSX render tree.
+ */
+export type PlainNode = string | number | boolean | null | undefined;
+/**
+ * A renderable JSX tree node.
+ *
+ * Supports primitive values, elements, nested arrays,
+ * and promised async nodes.
+ */
+export type Node = PlainNode | JSX.Element | Node[] | Promise<PlainNode | JSX.Element | Node[]>;
+/**
+ * Union type of all normalized render tree elements.
+ */
+export type Element = PlainElement | FragmentElement | IntrinsicElement;
+/**
+ * Functional JSX component signature for the renderer.
+ */
+export type Component = (props: any) => JSX.Element | Promise<JSX.Element>;
+/**
+ * Plain text render node.
+ */
+export interface PlainElement {
+    type: "plain";
+    value: PlainNode;
+}
+/**
+ * Fragment render node used to group multiple children.
+ */
+export interface FragmentElement {
+    type: "fragment";
+    children: JSX.Element[];
+}
+/**
+ * Intrinsic JSX render node with serialized entity metadata.
+ */
+export interface IntrinsicElement {
+    id: string;
+    type: "intrinsic";
+    entity: Entity;
+    children: JSX.Element[];
+}
+/**
+ * Supported Telegram time formatting tokens.
+ */
+export type TimeFormat = "r" | `${"w" | ""}${"d" | "D" | ""}${"t" | "T" | ""}`;
+/**
+ * Supported syntax highlighting language identifiers for `codeblock`.
+ *
+ * Includes all Prism-compatible language aliases plus custom strings.
+ */
+export type CodeBlockLanguages = (string & {}) | "markup" | "html" | "xml" | "svg" | "mathml" | "ssml" | "atom" | "rss" | "css" | "clike" | "regex" | "javascript" | "js" | "abap" | "abnf" | "actionscript" | "ada" | "agda" | "al" | "antlr4" | "g4" | "apacheconf" | "sql" | "apex" | "apl" | "applescript" | "aql" | "c" | "cpp" | "arduino" | "ino" | "arff" | "armasm" | "arm-asm" | "bash" | "sh" | "shell" | "yaml" | "yml" | "markdown" | "md" | "arturo" | "art" | "asciidoc" | "adoc" | "csharp" | "cs" | "dotnet" | "aspnet" | "asm6502" | "asmatmel" | "autohotkey" | "autoit" | "avisynth" | "avs" | "avro-idl" | "avdl" | "awk" | "gawk" | "basic" | "batch" | "bbcode" | "shortcode" | "bbj" | "bicep" | "birb" | "bison" | "bnf" | "rbnf" | "bqn" | "brainfuck" | "brightscript" | "bro" | "cfscript" | "cfc" | "chaiscript" | "cil" | "cilkc" | "cilk-c" | "cilkcpp" | "cilk-cpp" | "cilk" | "clojure" | "cmake" | "cobol" | "coffeescript" | "coffee" | "concurnas" | "conc" | "csp" | "cooklang" | "ruby" | "rb" | "crystal" | "csv" | "cue" | "cypher" | "d" | "dart" | "dataweave" | "dax" | "dhall" | "diff" | "markup-templating" | "django" | "jinja2" | "dns-zone-file" | "dns-zone" | "docker" | "dockerfile" | "dot" | "gv" | "ebnf" | "editorconfig" | "eiffel" | "ejs" | "eta" | "elixir" | "elm" | "lua" | "etlua" | "erb" | "erlang" | "excel-formula" | "xlsx" | "xls" | "fsharp" | "factor" | "false" | "fift" | "firestore-security-rules" | "flow" | "fortran" | "ftl" | "func" | "gml" | "gamemakerlanguage" | "gap" | "gcode" | "gdscript" | "gedcom" | "gettext" | "po" | "git" | "glsl" | "gn" | "gni" | "linker-script" | "ld" | "go" | "go-module" | "go-mod" | "gradle" | "graphql" | "groovy" | "less" | "scss" | "textile" | "haml" | "handlebars" | "hbs" | "mustache" | "haskell" | "hs" | "haxe" | "hcl" | "hlsl" | "hoon" | "hpkp" | "hsts" | "json" | "webmanifest" | "uri" | "url" | "http" | "ichigojam" | "icon" | "icu-message-format" | "idris" | "idr" | "ignore" | "gitignore" | "hgignore" | "npmignore" | "inform7" | "ini" | "io" | "j" | "java" | "scala" | "php" | "javadoclike" | "javadoc" | "javastacktrace" | "jolie" | "jq" | "typescript" | "ts" | "jsdoc" | "n4js" | "n4jsd" | "json5" | "jsonp" | "jsstacktrace" | "julia" | "keepalived" | "keyman" | "kotlin" | "kt" | "kts" | "kusto" | "latex" | "tex" | "context" | "latte" | "scheme" | "lilypond" | "ly" | "liquid" | "lisp" | "emacs" | "elisp" | "emacs-lisp" | "livescript" | "llvm" | "log" | "lolcode" | "magma" | "makefile" | "mata" | "matlab" | "maxscript" | "mel" | "mermaid" | "metafont" | "mizar" | "mongodb" | "monkey" | "moonscript" | "moon" | "n1ql" | "nand2tetris-hdl" | "naniscript" | "nani" | "nasm" | "neon" | "nevod" | "nginx" | "nim" | "nix" | "nsis" | "objectivec" | "objc" | "ocaml" | "odin" | "opencl" | "openqasm" | "qasm" | "oz" | "parigp" | "parser" | "pascal" | "objectpascal" | "pascaligo" | "psl" | "pcaxis" | "px" | "peoplecode" | "pcode" | "perl" | "phpdoc" | "plant-uml" | "plantuml" | "plsql" | "powerquery" | "pq" | "mscript" | "powershell" | "processing" | "prolog" | "promql" | "properties" | "protobuf" | "stylus" | "twig" | "pug" | "puppet" | "purebasic" | "pbfasm" | "python" | "py" | "qsharp" | "qs" | "q" | "qml" | "qore" | "r" | "racket" | "rkt" | "cshtml" | "razor" | "jsx" | "tsx" | "reason" | "rego" | "renpy" | "rpy" | "rescript" | "res" | "rest" | "rip" | "roboconf" | "robotframework" | "robot" | "rust" | "sas" | "sass" | "shell-session" | "sh-session" | "shellsession" | "smali" | "smalltalk" | "smarty" | "sml" | "smlnj" | "solidity" | "sol" | "solution-file" | "sln" | "soy" | "splunk-spl" | "sqf" | "squirrel" | "stan" | "stata" | "iecst" | "supercollider" | "sclang" | "swift" | "systemd" | "tact" | "t4-templating" | "t4-cs" | "t4" | "vbnet" | "t4-vb" | "tap" | "tcl" | "tt2" | "toml" | "ttcn" | "ttcn3" | "ttcn-3" | "turtle" | "trickle" | "typescript-jsdoc" | "typoscript" | "tsconfig" | "unrealscript" | "uscript" | "uc" | "v" | "vala" | "vba" | "vbscript" | "velocity" | "verilog" | "vhdl" | "vim" | "visual-basic" | "vb" | "warpscript" | "wasm" | "web-idl" | "webidl" | "wgsl" | "wiki" | "wolfram" | "mathematica" | "nb" | "wl" | "xeora" | "xeoracube" | "xml-doc" | "xojo" | "xquery" | "yang" | "zig";
+export type { JSX };
+//# sourceMappingURL=jsx.types.d.ts.map

package/dist/types/jsx.types.d.ts.map

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

package/dist/types/jsx.types.js

@@ -0,0 +1,29 @@
+// ! Intrinsic elements
+/**
+ * Runtime registry of all supported intrinsic JSX elements.
+ *
+ * This object defines the canonical intrinsic tag surface supported by
+ * the Telegram JSX renderer.
+ *
+ * Use {@link IntrinsicElements} for the inferred type-safe version.
+ */
+export const intrinsicElements = {
+    b: {},
+    i: {},
+    u: {},
+    s: {},
+    spoiler: {},
+    a: {},
+    emoji: {},
+    time: {},
+    code: {},
+    codeblock: {},
+    blockquote: {},
+    h: {},
+    p: {},
+    br: {},
+    img: {},
+    preview: {},
+    button: {},
+};
+//# sourceMappingURL=jsx.types.js.map

package/dist/types/jsx.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.types.js","sourceRoot":"","sources":["../../src/types/jsx.types.ts"],"names":[],"mappings":"AA6BA,uBAAuB;AAEvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,CAAC,EAAE,EAAkB;IACrB,CAAC,EAAE,EAAkB;IACrB,CAAC,EAAE,EAAkB;IACrB,CAAC,EAAE,EAAkB;IACrB,OAAO,EAAE,EAAkB;IAC3B,CAAC,EAAE,EAAoC;IACvC,KAAK,EAAE,EAAkC;IACzC,IAAI,EAAE,EAAyD;IAC/D,IAAI,EAAE,EAAkB;IACxB,SAAS,EAAE,EAAiD;IAC5D,UAAU,EAAE,EAA4C;IACxD,CAAC,EAAE,EAAkB;IACrB,CAAC,EAAE,EAAkB;IACrB,EAAE,EAAE,EAAQ;IACZ,GAAG,EAAE,EAAqE;IAC1E,OAAO,EAAE,EAA4E;IACrF,MAAM,EAAE,EAAqC;CACd,CAAC"}

package/dist/types/lib.types.d.ts

@@ -0,0 +1,80 @@
+import type { InputFile, InputMediaPhoto, OtherContexted } from "./grammy.types";
+import type { IntrinsicElements, JSX } from "./jsx.types";
+import type { ReactiveContext } from "./plugin.types";
+/**
+ * Represents the asynchronous result of the message render pipeline.
+ *
+ * Includes the final serialized text, Telegram API options,
+ * selected render target view, generated media collection,
+ * and an optional primary photo attachment.
+ *
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ */
+export type RenderedMessage<Other extends OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">> = Promise<{
+    text: string;
+    other: Other;
+    view: RenderedViewType;
+    media: InputMediaPhoto[];
+    photo: InputFile | undefined;
+}>;
+/**
+ * Input options required to render a JSX tree into a Telegram message payload.
+ *
+ * This type defines the full context passed into the render pipeline,
+ * including runtime context, render method metadata, unique render ID,
+ * and optional intrinsic restrictions.
+ *
+ * @template {ReactiveContext} C
+ * @template {OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">} Other
+ */
+export type RenderedMessageOptions<C extends ReactiveContext, Other extends OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">> = {
+    method: string;
+    jsx: JSX.Element[] | JSX.Element;
+    ctx: C;
+    other: Other;
+    id: string;
+    unallowed?: (keyof IntrinsicElements)[];
+};
+/**
+ * Defines the render target mode selected by the message serializer.
+ *
+ * - `"message"` renders the content as message text
+ * - `"caption"` renders the content as media caption
+ */
+export type RenderedViewType = "message" | "caption";
+/**
+ * Describes the lifecycle contract for a reactive bot handler instance.
+ *
+ * Lifecycle hooks are used to mount, rerender, and unmount
+ * dynamic JSX-driven bot views.
+ *
+ * @template {ReactiveContext} C
+ */
+export type BotHandlerLifecycle<C extends ReactiveContext> = (ctx: C) => {
+    mount: () => Promise<void>;
+    rerender: () => Promise<void>;
+    unmount: () => Promise<void>;
+    error: (error: Error) => Promise<void>;
+    controller: AbortController;
+};
+/**
+ * Resolves the concrete lifecycle instance returned by
+ * {@link BotHandlerLifecycle}.
+ *
+ * @template {ReactiveContext} C
+ */
+export type BotHandlerLifecycleInstance<C extends ReactiveContext> = ReturnType<BotHandlerLifecycle<C>>;
+/**
+ * Defines a reactive bot message render handler.
+ *
+ * Reactive handlers receive lifecycle controls, context,
+ * and hook-based event helpers such as state management.
+ *
+ * @template {ReactiveContext} C
+ */
+export type BotMessageHandler<C extends ReactiveContext> = (event: {
+    ctx: C;
+    id: string;
+    controller?: AbortController;
+}) => JSX.Element | Promise<JSX.Element>;
+//# sourceMappingURL=lib.types.d.ts.map

package/dist/types/lib.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.types.d.ts","sourceRoot":"","sources":["../../src/types/lib.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAW,iBAAiB,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CACvB,KAAK,SAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,IAC9E,OAAO,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,CAC9B,CAAC,SAAS,eAAe,EACzB,KAAK,SAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,IAC9E;IACA,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC;IACP,KAAK,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,CAAC,MAAM,iBAAiB,CAAC,EAAE,CAAC;CAC3C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAIrD;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK;IACrE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,EAAE,eAAe,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,CACnC,CAAC,SAAS,eAAe,IACzB,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAIvC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI,CACvD,KAAK,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,eAAe,CAAA;CAAE,KAC1D,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/lib.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=lib.types.js.map

package/dist/types/lib.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.types.js","sourceRoot":"","sources":["../../src/types/lib.types.ts"],"names":[],"mappings":""}