@xlsft/grammy-reactive 0.7.34

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright © 2026 xlsft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/jsx/index.d.ts

@@ -0,0 +1,3 @@
+export { createChildren, createEntity, createIntrinsicElement, createElement, createFragment, createRoot } from "./runtime/jsx";
+export type { JSX } from "./runtime/jsx.runtime";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,UAAU,EACb,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/jsx/index.js

@@ -0,0 +1,2 @@
+export { createChildren, createEntity, createIntrinsicElement, createElement, createFragment, createRoot } from "./runtime/jsx";
+//# sourceMappingURL=index.js.map

package/dist/jsx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,UAAU,EACb,MAAM,eAAe,CAAA"}

package/dist/jsx/jsx-dev-runtime.d.ts

@@ -0,0 +1,2 @@
+export { type JSX, jsxDEV, jsxs, jsx, Fragment } from './runtime/jsx.runtime';
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../../src/jsx/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/jsx/jsx-dev-runtime.js

@@ -0,0 +1,2 @@
+export { jsxDEV, jsxs, jsx, Fragment } from './runtime/jsx.runtime';
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../../src/jsx/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/jsx/jsx-runtime.d.ts

@@ -0,0 +1,2 @@
+export { type JSX, jsxDEV, jsxs, jsx, Fragment } from './runtime/jsx.runtime';
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/jsx/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/jsx/jsx-runtime.js

@@ -0,0 +1,2 @@
+export { jsxDEV, jsxs, jsx, Fragment } from './runtime/jsx.runtime';
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../../src/jsx/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/jsx/runtime/jsx.d.ts

@@ -0,0 +1,10 @@
+import type { IntrinsicElements, FragmentElement, Node, IntrinsicElementOptions, EntityPropsMap, EntityFactoryMap, JSX } from '../../types/jsx.types.ts';
+export declare function createChildren(node: Node): Promise<JSX.Element[]>;
+export declare function createEntity<K extends keyof IntrinsicElements>(tag: K, props: EntityPropsMap[K]): EntityFactoryMap[K];
+export declare function createIntrinsicElement<T extends IntrinsicElementOptions>(options: T): Promise<JSX.Element>;
+export declare function createElement<T extends keyof IntrinsicElements>(type: T, props: IntrinsicElements[T], children: Node): JSX.Element | Promise<JSX.Element>;
+export declare function createFragment(props?: {
+    children?: Node;
+}): Promise<FragmentElement>;
+export declare function createRoot(type: any, props: any, key?: any): JSX.Element | Promise<JSX.Element>;
+//# sourceMappingURL=jsx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../../src/jsx/runtime/jsx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAER,iBAAiB,EACjB,eAAe,EACf,IAAI,EACJ,uBAAuB,EAEvB,cAAc,EACd,gBAAgB,EAEhB,GAAG,EACN,MAAM,0BAA0B,CAAA;AAIjC,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAwBvE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAKrH;AAED,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,uBAAuB,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAUhH;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAoB3J,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAK1F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,sCAO1D"}

package/dist/jsx/runtime/jsx.errors.d.ts

@@ -0,0 +1,4 @@
+export declare class JSXParseError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=jsx.errors.d.ts.map

package/dist/jsx/runtime/jsx.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.errors.d.ts","sourceRoot":"","sources":["../../../src/jsx/runtime/jsx.errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBACxB,OAAO,CAAC,EAAE,MAAM;CAI/B"}

package/dist/jsx/runtime/jsx.errors.js

@@ -0,0 +1,7 @@
+export class JSXParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "JSXParseError";
+    }
+}
+//# sourceMappingURL=jsx.errors.js.map

package/dist/jsx/runtime/jsx.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.errors.js","sourceRoot":"","sources":["../../../src/jsx/runtime/jsx.errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpC,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC/B,CAAC;CACJ"}

package/dist/jsx/runtime/jsx.js

@@ -0,0 +1,209 @@
+import { generateUniqueId, isIntrinsicElement } from 'src/utils';
+/**
+ * Recursively resolves and normalizes a {@link Node} into a flat array of {@link Element Elements}.
+ *
+ * This utility is responsible for converting JSX-like child nodes into the
+ * internal render tree representation used by the message builder.
+ *
+ * Supported normalization rules:
+ * - `null`, `undefined`, and `boolean` values are ignored
+ * - `string` and `number` values are converted into {@link PlainElement}
+ * - nested `Node[]` arrays are recursively resolved and flattened
+ * - existing {@link Element} objects are preserved as-is
+ * - promised nodes are awaited before normalization
+ *
+ * This makes the function suitable for processing `children` values from
+ * intrinsic elements, fragments, and async components.
+ *
+ * @async
+ * @param {Node} node - A render node, nested node list, or promised node value.
+ * @returns {Promise<JSX.Element[]>} A promise that resolves to a flat normalized array
+ * of renderable elements.
+ *
+ * @example
+ * const children = await createChildren([
+ *   "Hello",
+ *   ["world", 123],
+ *   null,
+ * ]);
+ *
+ * // [
+ * //   { type: "plain", value: "Hello" },
+ * //   { type: "plain", value: "world" },
+ * //   { type: "plain", value: 123 }
+ * // ]
+ */
+export async function createChildren(node) {
+    const resolved = await node;
+    if (resolved == null || typeof resolved === "boolean")
+        return [];
+    const type = typeof resolved;
+    if (type === "string" || type === "number") {
+        return [{ type: "plain", value: resolved }];
+    }
+    if (Array.isArray(resolved)) {
+        const children = await Promise.all(resolved.map(createChildren));
+        return children.flat();
+    }
+    return [resolved];
+}
+/**
+ * Creates a strongly typed entity descriptor for the given intrinsic tag.
+ *
+ * This is a low-level factory used to convert an intrinsic JSX tag and its
+ * normalized props into an internal {@link Entity} representation.
+ *
+ * The returned entity type is inferred from the provided `tag`, ensuring
+ * that the resulting shape matches the corresponding entry in
+ * `IntrinsicElements`.
+ *
+ * Commonly used when transforming JSX nodes into {@link TextElement}
+ * metadata entities such as links, formatting marks, timestamps, emojis,
+ * buttons, and other supported Telegram entities.
+ *
+ * @template {keyof IntrinsicElements} K
+ * @param {K} tag - The intrinsic element tag name.
+ * @param {EntityPropsMap[K]} props - The normalized props associated with the tag.
+ * @returns {EntityFactoryMap[K]} A strongly typed entity object for the given tag.
+ *
+ * @example
+ * const link = createEntity("a", { href: "https://example.com" });
+ * // { type: "a", href: "https://example.com" }
+ *
+ * @example
+ * const emoji = createEntity("emoji", { id: "123456789" });
+ * // { type: "emoji", id: "123456789" }
+ */
+export function createEntity(tag, props) {
+    return {
+        type: tag,
+        ...props,
+    };
+}
+/**
+ * Creates an intrinsic {@link TextElement} from a JSX-like intrinsic node definition.
+ *
+ * This function validates the provided intrinsic tag, extracts and normalizes
+ * its `children`, converts the remaining props into a strongly typed
+ * {@link Entity}, and returns the final internal render-tree node.
+ *
+ * It acts as the main transformation step for intrinsic JSX tags such as
+ * formatting entities (`b`, `i`, `a`, `code`), media nodes (`img`, `preview`),
+ * structural blocks (`blockquote`, `p`, `h`), and interactive elements
+ * like inline keyboard buttons.
+ *
+ * Children are recursively resolved through {@link createChildren}, which
+ * allows support for nested arrays, async nodes, primitive values, and
+ * already constructed elements.
+ *
+ * @template {IntrinsicElementOptions} T
+ * @async
+ * @param {T} options - Intrinsic element creation options including the tag and its props.
+ * @returns {Promise<JSX.Element>} A promise that resolves to the normalized intrinsic text element.
+ *
+ * @throws {Error} Throws if the provided tag is not a supported intrinsic element.
+ *
+ * @example
+ * const element = await createIntrinsicElement({
+ *     tag: "a",
+ *     props: {
+ *         href: "https://example.com",
+ *         children: "Open link",
+ *     },
+ * });
+ */
+export async function createIntrinsicElement(options) {
+    if (!isIntrinsicElement(options.tag))
+        throw new Error(`Invalid intrinsic element: ${options.tag}`);
+    const children = "children" in options.props ? options.props.children ?? [] : [];
+    const { children: _, ...props } = options.props;
+    return {
+        id: generateUniqueId(),
+        type: "intrinsic",
+        entity: createEntity(options.tag, props),
+        children: await createChildren(children),
+    };
+}
+export function createElement(type, props, children) {
+    const intrinsicElementProps = children === undefined ? props : { ...props, children };
+    if (typeof type === "string") {
+        if (!isIntrinsicElement(type))
+            throw new Error(`Invalid JSX component: ${type}.`);
+        return createIntrinsicElement({ tag: type, props: intrinsicElementProps });
+    }
+    if (typeof type === "function")
+        return type(intrinsicElementProps);
+    throw new Error(`Invalid JSX component: ${type}.`);
+}
+/**
+ * Creates a JSX fragment node by normalizing its children into a
+ * {@link FragmentElement}.
+ *
+ * Fragments are used to group multiple child nodes without introducing
+ * an additional intrinsic entity wrapper in the render tree.
+ *
+ * This makes the function suitable as the runtime target for JSX fragment
+ * syntax (`<>...</>`), allowing multiple sibling nodes to be returned
+ * from components or embedded inline in intrinsic children.
+ *
+ * All provided children are recursively resolved and flattened through
+ * {@link createChildren}, which supports async nodes, nested arrays,
+ * primitive values, and existing elements.
+ *
+ * @async
+ * @param {{ children?: Node }} [props] - Optional fragment props containing child nodes.
+ * @returns {Promise<FragmentElement>} A promise that resolves to the normalized fragment node.
+ *
+ * @example
+ * const fragment = await createFragment({
+ *     children: ["Hello", " ", "world"],
+ * });
+ *
+ * // {
+ * //     type: "fragment",
+ * //     children: [
+ * //         { type: "plain", value: "Hello" },
+ * //         { type: "plain", value: " " },
+ * //         { type: "plain", value: "world" }
+ * //     ]
+ * // }
+ */
+export async function createFragment(props) {
+    return {
+        type: 'fragment',
+        children: await createChildren(props?.children ?? []),
+    };
+}
+/**
+ * Creates a root JSX runtime node from compiler-transformed JSX input.
+ *
+ * This function serves as the top-level JSX factory entry used by modern
+ * JSX transforms, where `type`, `props`, and an optional `key` are passed
+ * directly by the compiler.
+ *
+ * It normalizes missing props, preserves the optional `key` field when
+ * provided, extracts `children` from props, and delegates actual element
+ * creation to {@link createElement}.
+ *
+ * This makes it suitable as the runtime target for `jsx`, `jsxs`,
+ * or similar compiler-generated calls in a custom JSX runtime.
+ *
+ * @param {any} type - The intrinsic tag or functional component.
+ * @param {any} props - The JSX props object generated by the compiler.
+ * @param {any} [key] - Optional JSX key passed by the transform.
+ * @returns {JSX.Element | Promise<JSX.Element>} The created render-tree node.
+ *
+ * @example
+ * const node = createRoot("b", { children: "Hello" });
+ *
+ * @example
+ * const node = createRoot(MyComponent, { value: 42 }, "item-1");
+ */
+export function createRoot(type, props, key) {
+    props ??= {};
+    const children = props.children;
+    if (key !== undefined)
+        props.key = key;
+    return createElement(type, props, children);
+}
+//# sourceMappingURL=jsx.js.map

package/dist/jsx/runtime/jsx.js.map

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

package/dist/jsx/runtime/jsx.runtime.d.ts

@@ -0,0 +1,18 @@
+import type { Element as _Element, IntrinsicElements as _IntrinsicElements, Component as _Component } from '~/types/jsx.types.ts';
+import { createRoot, createFragment } from './jsx.ts';
+export { createFragment as Fragment, createRoot as jsx, createRoot as jsxDEV, createRoot as jsxs, };
+export declare namespace JSX {
+    type Element = _Element | Promise<_Element>;
+    type ElementType = keyof _IntrinsicElements | _Component;
+    interface ElementAttributesProperty {
+        props: {};
+    }
+    interface ElementChildrenAttribute {
+        children: {};
+    }
+    interface IntrinsicElements extends _IntrinsicElements {
+    }
+    interface IntrinsicAttributes {
+    }
+}
+//# sourceMappingURL=jsx.runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.runtime.d.ts","sourceRoot":"","sources":["../../../src/jsx/runtime/jsx.runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,OAAO,IAAI,QAAQ,EACnB,iBAAiB,IAAI,kBAAkB,EACvC,SAAS,IAAI,UAAU,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,EACH,cAAc,IAAI,QAAQ,EAC1B,UAAU,IAAI,GAAG,EACjB,UAAU,IAAI,MAAM,EACpB,UAAU,IAAI,IAAI,GACrB,CAAA;AAED,yBAAiB,GAAG,CAAC;IACjB,KAAY,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClD,KAAY,WAAW,GAAG,MAAM,kBAAkB,GAAG,UAAU,CAAA;IAC/D,UAAiB,yBAAyB;QAAG,KAAK,EAAE,EAAE,CAAA;KAAE;IACxD,UAAiB,wBAAwB;QAAG,QAAQ,EAAE,EAAE,CAAA;KAAE;IAC1D,UAAiB,iBAAkB,SAAQ,kBAAkB;KAAG;IAChE,UAAiB,mBAAmB;KAAG;CAC1C"}

package/dist/jsx/runtime/jsx.runtime.js

@@ -0,0 +1,3 @@
+import { createRoot, createFragment } from './jsx.ts';
+export { createFragment as Fragment, createRoot as jsx, createRoot as jsxDEV, createRoot as jsxs, };
+//# sourceMappingURL=jsx.runtime.js.map

package/dist/jsx/runtime/jsx.runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.runtime.js","sourceRoot":"","sources":["../../../src/jsx/runtime/jsx.runtime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,EACH,cAAc,IAAI,QAAQ,EAC1B,UAAU,IAAI,GAAG,EACjB,UAAU,IAAI,MAAM,EACpB,UAAU,IAAI,IAAI,GACrB,CAAA"}

package/dist/lib/helpers/context.helper.d.ts

@@ -0,0 +1,3 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare function useContext<C extends ReactiveContext = ReactiveContext>(): C;
+//# sourceMappingURL=context.helper.d.ts.map

package/dist/lib/helpers/context.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.helper.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/context.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,KAAK,CAAC,CAQ3E"}

package/dist/lib/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export { useContext } from "./context.helper";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,12 @@
+import { type BotMessageHandler } from "~/types/lib.types";
+import { reactive } from "./plugin";
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare function defineMessageHandler<C extends ReactiveContext>(handler: BotMessageHandler<C>): (ctx: C) => Promise<void>;
+export { reactive };
+export { createMessageRender } from "./render/message.render";
+export * from "./state/hooks";
+export * from "./helpers";
+export type { JSX } from "../jsx/runtime/jsx.runtime";
+export type { PluginOptions as Options, ReactiveContextFlavor as ReactiveFlavor } from "../types/plugin.types";
+export type { BotMessageHandler as MessageHandler } from '../types/lib.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC1D,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAEf,KAAK,CAAC,mBAUvB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,YAAY,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAA;AACrD,YAAY,EACR,aAAa,IAAI,OAAO,EACxB,qBAAqB,IAAI,cAAc,EAC1C,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACR,iBAAiB,IAAI,cAAc,EACtC,MAAM,oBAAoB,CAAA"}

package/dist/lib/index.js

@@ -0,0 +1,45 @@
+import {} from "~/types/lib.types";
+import { jsx } from "./plugin";
+import { generateUniqueId } from "~/utils";
+import { createMessageState } from "./state/create.state";
+/**
+ * Creates a reactive message handler executor.
+ *
+ * Reactive handlers extend the static lifecycle model with
+ * hook-based state utilities such as `useState`, enabling
+ * dynamic rerendering flows and interactive message updates.
+ *
+ * This helper initializes:
+ * - a unique message lifecycle session
+ * - persistent reactive state storage
+ * - hook bindings
+ * - the initial mounted render
+ *
+ * Best suited for interactive Telegram UIs, stateful menus,
+ * pagination, toggles, and multi-step flows.
+ *
+ * @template {ReactiveContext} C
+ * @param {BotMessageHandler<C>} handler
+ * The reactive JSX message handler definition.
+ * @returns {(ctx: C) => Promise<void>}
+ * An async context-bound executor that mounts the reactive lifecycle.
+ *
+ * @example
+ * export default defineMessageHandler(async ({ useState }) => {
+ *     const [count, setCount] = useState(0);
+ *     return <>
+ *         <button variant="callback" onClick={() => setCount(count + 1)}>+</button>
+ *         <button variant="callback" onClick={() => setCount(count - 1)}>-</button>
+ *     </>;
+ * });
+ */
+export function defineMessageHandler(handler) {
+    return async (ctx) => {
+        const id = generateUniqueId();
+        const state = createMessageState({ id, ctx, handler });
+        await state.mount();
+    };
+}
+export { jsx as jsxPlugin };
+export { createMessageRender } from "./render/message.render";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAA6B;IAE7B,OAAO,KAAK,EAAE,GAAM,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;QACtD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC,CAAA;AACL,CAAC;AAED,OAAO,EAAE,GAAG,IAAI,SAAS,EAAE,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/lib/jsx-runtime.d.ts

@@ -0,0 +1,2 @@
+export { type JSX, jsxDEV, jsxs, jsx, Fragment } from './runtime/jsx.runtime';
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/lib/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/lib/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/lib/plugin/index.d.ts

@@ -0,0 +1,4 @@
+import type { MiddlewareFn } from "~/types/grammy.types";
+import type { PluginOptions, ReactiveContext, ReactiveContextFlavor } from "~/types/plugin.types";
+export declare function reactive<C extends ReactiveContext>(options?: PluginOptions<C>): MiddlewareFn<ReactiveContextFlavor<C>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAiB,MAAM,sBAAsB,CAAC;AAOjH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CA8CtH"}

package/dist/lib/plugin/index.js

@@ -0,0 +1,40 @@
+import { createOnClickEvent } from "../state/events/onclick.event";
+import { generateUniqueId } from "~/utils";
+import { createMessageRender } from "../render/message.render";
+import { JSXParseError } from "~/jsx/runtime/jsx.errors";
+export function jsx({ bot }) {
+    return async (ctx, next) => {
+        bot.on("callback_query:data", createOnClickEvent);
+        ctx.reply = async function reply(content, other, signal) {
+            const dispatch = async (content) => {
+                if (!ctx.chat)
+                    throw new Error("Cannot reply to a message without a chat");
+                return await ctx.api.sendMessage(ctx.chat.id, content, {
+                    business_connection_id: ctx.businessConnectionId,
+                    ...(ctx.msg?.is_topic_message
+                        ? { message_thread_id: ctx.msg.message_thread_id }
+                        : {}),
+                    direct_messages_topic_id: ctx.msg?.direct_messages_topic?.topic_id,
+                    ...other,
+                }, signal);
+            };
+            if (typeof content === "string") {
+                return await dispatch(content);
+            }
+            else {
+                const id = generateUniqueId();
+                const message = await createMessageRender({
+                    method: "repl", id,
+                    jsx: content, ctx, other: {},
+                    unallowed: ['img']
+                });
+                other = message.other;
+                if (!message)
+                    throw new JSXParseError("No message rendered");
+                return await dispatch(message.text);
+            }
+        };
+        await next();
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/plugin/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,UAAU,GAAG,CAA4B,EAAE,GAAG,EAAoB;IACpE,OAAO,KAAK,EAAE,GAA6B,EAAE,IAAkB,EAAE,EAAE;QAE/D,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAA;QAEjD,GAAG,CAAC,KAAK,GAAG,KAAK,UAAU,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM;YACnD,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAe,EAAE,EAAE;gBACvC,IAAI,CAAC,GAAG,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;gBAC1E,OAAO,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE;oBACnD,sBAAsB,EAAE,GAAG,CAAC,oBAAoB;oBAChD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB;wBACzB,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE;wBAClD,CAAC,CAAC,EAAE,CAAC;oBACT,wBAAwB,EAAE,GAAG,CAAC,GAAG,EAAE,qBAAqB,EAAE,QAAQ;oBAClE,GAAG,KAAK;iBACX,EAAE,MAAa,CAAC,CAAA;YACrB,CAAC,CAAA;YACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;YAClC,CAAC;iBAAM,CAAC;gBACJ,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAA;gBAC7B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAEvC;oBACE,MAAM,EAAE,MAAM,EAAE,EAAE;oBAClB,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;oBAC5B,SAAS,EAAE,CAAC,KAAK,CAAC;iBACrB,CAAC,CAAA;gBACF,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;gBACrB,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAA;gBAC5D,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACvC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,IAAI,EAAE,CAAC;IACjB,CAAC,CAAC;AACN,CAAC"}

package/dist/lib/render/components/Error.d.ts

@@ -0,0 +1,26 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+/**
+ * Renders the internal fallback error UI for failed lifecycle sessions.
+ *
+ * This diagnostic component is used by the lifecycle error boundary
+ * to replace a failed reactive message with a developer-friendly
+ * formatted error report.
+ *
+ * The rendered output includes:
+ * - exception type
+ * - error message
+ * - stack trace
+ * - lifecycle request ID
+ *
+ * The request ID helps correlate the rendered fallback message
+ * with the owning lifecycle session and callback flow.
+ *
+ * @param {{ error: Error; id: string }} props - Error display payload.
+ * @returns {JSX.Element} The formatted internal error message view.
+ */
+export declare function InternalError<C extends ReactiveContext>({ error, id, retry }: {
+    error: Error;
+    id?: string;
+    retry?: () => Promise<void>;
+}): import("src/jsx/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Error.d.ts.map

package/dist/lib/render/components/Error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/components/Error.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAAE,6CAuBzI"}

package/dist/lib/render/components/Error.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "src/jsx/jsx-runtime";
+/**
+ * Renders the internal fallback error UI for failed lifecycle sessions.
+ *
+ * This diagnostic component is used by the lifecycle error boundary
+ * to replace a failed reactive message with a developer-friendly
+ * formatted error report.
+ *
+ * The rendered output includes:
+ * - exception type
+ * - error message
+ * - stack trace
+ * - lifecycle request ID
+ *
+ * The request ID helps correlate the rendered fallback message
+ * with the owning lifecycle session and callback flow.
+ *
+ * @param {{ error: Error; id: string }} props - Error display payload.
+ * @returns {JSX.Element} The formatted internal error message view.
+ */
+export function InternalError({ error, id }) {
+    const stack = error.stack || `${error.name}: ${error.message}\n    at unknown`;
+    return _jsxs(_Fragment, { children: [_jsx("h", { children: "\u26A0\uFE0F Internal Error" }), _jsxs("blockquote", { expandable: true, children: [_jsx("b", { children: "Exception:" }), " ", _jsx("code", { children: error.name || "Error" }), _jsx("br", {}), _jsx("b", { children: "Message:" }), " ", _jsx("i", { children: error.message || "Unknown error" })] }), _jsx("br", {}), _jsx("br", {}), _jsx("h", { children: "\uD83D\uDCCD Stack Trace" }), _jsx("codeblock", { lang: "ts", children: stack }), _jsx("br", {}), _jsx("br", {}), _jsxs("i", { children: ["Request ID: ", _jsx("code", { children: id })] })] });
+}
+//# sourceMappingURL=Error.js.map

package/dist/lib/render/components/Error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.js","sourceRoot":"","sources":["../../../../src/lib/render/components/Error.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,EAAgC;IACrE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,kBAAkB,CAAA;IAC9E,OAAO,8BACH,sDAAwB,EACxB,sBAAY,UAAU,mBAClB,qCAAiB,OAAC,yBAAO,KAAK,CAAC,IAAI,IAAI,OAAO,GAAQ,EACtD,cAAM,EACN,mCAAe,OAAC,sBAAI,KAAK,CAAC,OAAO,IAAI,eAAe,GAAK,IAChD,EAAA,cAAK,EAAA,cAAK,EACvB,mDAAqB,EACrB,oBAAW,IAAI,EAAC,IAAI,YACf,KAAK,GACE,EAAA,cAAK,EAAA,cAAK,EACtB,wCAAe,yBAAO,EAAE,GAAQ,IAAI,IACrC,CAAA;AACP,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+import type { RenderedMessage, RenderedMessageOptions } from "~/types/lib.types";
+import type { OtherContexted } 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 declare function createMessageRender<C extends ReactiveContext, Other extends OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">>(options: RenderedMessageOptions<C, Other>): RenderedMessage<Other>;
+//# sourceMappingURL=message.render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.render.d.ts","sourceRoot":"","sources":["../../../src/lib/render/message.render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAG5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,SAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,EAC/I,OAAO,EAAE,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,GAC1C,eAAe,CAAC,KAAK,CAAC,CA4BxB"}