@xlsft/grammy-reactive 0.7.34

package/dist/types/plugin.types.d.ts

@@ -0,0 +1,81 @@
+import type { Context, Message, OtherContexted } from "./grammy.types";
+import type { JSX } from "./jsx.types";
+/**
+ * Excludes `undefined` from a union type.
+ *
+ * Commonly used to normalize optional generic parameters
+ * into a required variant for internal render pipelines.
+ *
+ * @template T
+ */
+export type RequiredUnion<T> = T extends undefined ? never : T;
+/**
+ * Represents a value that can be provided either as a single item
+ * or as an array of items of the same type.
+ *
+ * Useful for APIs that accept both:
+ * - a single value
+ * - multiple values
+ *
+ * @template T
+ *
+ * @example
+ * type Input = MaybeArray<string>;
+ * // string | string[]
+ */
+export type MaybeArray<T> = T | T[];
+/**
+ * Configuration options for the reactive plugin runtime.
+ *
+ * Used to provide the target options for
+ * middleware registration
+ *
+ * @template C
+ *
+ * @example
+ * const options: PluginOptions<MyContext> = {
+ *
+ * };
+ */
+export type PluginOptions<C extends Context> = {} | undefined;
+/**
+ * Augments a Grammy context type with reactive runtime capabilities.
+ *
+ * This utility flavor composes the base Grammy `Context` with
+ * {@link ReactiveContextExtension}, making all reactive helpers
+ * available on the resulting context type.
+ *
+ * Useful for strongly typed middleware pipelines, plugins, and
+ * custom bot context definitions.
+ *
+ * @template {Context} C
+ */
+export type ReactiveContextFlavor<C extends Context> = C & ReactiveContextExtension;
+/**
+ * A minimal reactive Grammy context type based on the standard `Context`.
+ *
+ * This is a convenience alias for:
+ * `ReactiveContextFlavor<Context>`.
+ *
+ * Useful when no custom context extensions are required.
+ */
+export type ReactiveContext = ReactiveContextFlavor<Context>;
+/**
+ * Extends the Grammy context with JSX-based messaging helpers.
+ *
+ * These methods render JSX trees into Telegram-compatible HTML messages
+ * and forward the result to the corresponding context or raw API method.
+ */
+export interface ReactiveContextExtension {
+    /**
+     * Context-aware alias for api.sendMessage with JSX support. Use this method to send text messages with JSX markup.
+     * On success, the sent Message is returned.
+     *
+     * @param jsx  — JSX of the message to be sent, 1-4096 characters after entities parsing and render
+     * @param other — Optional remaining parameters, confer the official reference below
+     * @param signal
+     * Optional AbortSignal to cancel the request
+     */
+    reply(jsx: MaybeArray<JSX.Element>, other?: OtherContexted<"sendMessage", "text" | "chat_id" | "parse_mode">, signal?: AbortSignal): Promise<Message.TextMessage>;
+}
+//# sourceMappingURL=plugin.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.types.d.ts","sourceRoot":"","sources":["../../src/types/plugin.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAO,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAIvC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AAInC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,IAAI,EAE9C,GAAG,SAAS,CAAC;AAId;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,GAAG,wBAAwB,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;;;;;OAQG;IACH,KAAK,CACD,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAC5B,KAAK,CAAC,EAAE,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,EACxE,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;CACnC"}

package/dist/types/plugin.types.js

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

package/dist/types/plugin.types.js.map

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

package/dist/utils/generateUniqueId.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generates a cryptographically strong unique identifier string.
+ *
+ * The identifier is built from 16 cryptographically secure random bytes
+ * using `crypto.getRandomValues()` and encoded as a fixed-length base36
+ * string.
+ *
+ * To guarantee uniqueness within the current runtime instance, generated
+ * identifiers are checked against a global in-memory registry and regenerated
+ * until a non-colliding value is produced.
+ *
+ * This makes the function suitable for stable runtime IDs such as:
+ * - reactive node identifiers
+ * - subscription keys
+ * - render instance tracking
+ * - component lifecycle registries
+ *
+ * @returns {string} A unique 16-character base36 identifier.
+ *
+ * @remarks
+ * Uniqueness is guaranteed only within the current process lifetime
+ * while `globalIdSet` is preserved.
+ *
+ * @example
+ * const id = generateUniqueId();
+ * // "a8k2x4p1m9z0q7rs"
+ */
+export declare function generateUniqueId(): string;
+//# sourceMappingURL=generateUniqueId.d.ts.map

package/dist/utils/generateUniqueId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateUniqueId.d.ts","sourceRoot":"","sources":["../../src/utils/generateUniqueId.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC"}

package/dist/utils/generateUniqueId.js

@@ -0,0 +1,41 @@
+import { globalIdSet } from "./global";
+/**
+ * Generates a cryptographically strong unique identifier string.
+ *
+ * The identifier is built from 16 cryptographically secure random bytes
+ * using `crypto.getRandomValues()` and encoded as a fixed-length base36
+ * string.
+ *
+ * To guarantee uniqueness within the current runtime instance, generated
+ * identifiers are checked against a global in-memory registry and regenerated
+ * until a non-colliding value is produced.
+ *
+ * This makes the function suitable for stable runtime IDs such as:
+ * - reactive node identifiers
+ * - subscription keys
+ * - render instance tracking
+ * - component lifecycle registries
+ *
+ * @returns {string} A unique 16-character base36 identifier.
+ *
+ * @remarks
+ * Uniqueness is guaranteed only within the current process lifetime
+ * while `globalIdSet` is preserved.
+ *
+ * @example
+ * const id = generateUniqueId();
+ * // "a8k2x4p1m9z0q7rs"
+ */
+export function generateUniqueId() {
+    const generate = () => {
+        const bytes = new Uint8Array(16);
+        crypto.getRandomValues(bytes);
+        return Array.from(bytes, byte => (byte % 36).toString(36)).join("");
+    };
+    let id = generate();
+    while (globalIdSet.has(id))
+        id = generate();
+    globalIdSet.add(id);
+    return id;
+}
+//# sourceMappingURL=generateUniqueId.js.map

package/dist/utils/generateUniqueId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateUniqueId.js","sourceRoot":"","sources":["../../src/utils/generateUniqueId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB;IAC5B,MAAM,QAAQ,GAAG,GAAG,EAAE;QAClB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC,CAAA;IACD,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IACpB,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,EAAE,GAAG,QAAQ,EAAE,CAAA;IAC3C,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACnB,OAAO,EAAE,CAAC;AACd,CAAC"}

package/dist/utils/getEmoji.d.ts

@@ -0,0 +1,26 @@
+import type { IntrinsicElement, IntrinsicElements } from "~/types/jsx.types";
+/**
+ * Finds the first direct emoji intrinsic child entity within an element.
+ *
+ * This utility performs a shallow scan over the element's immediate
+ * `children` collection and returns the first child whose intrinsic
+ * entity type is `"emoji"`.
+ *
+ * Only direct children are inspected. Nested descendants inside child
+ * branches are not traversed.
+ *
+ * Useful for extracting decorative or semantic emoji metadata from
+ * JSX-generated intrinsic trees.
+ *
+ * @param {IntrinsicElement} element - The intrinsic element whose direct children should be scanned.
+ * @returns {IntrinsicElements["emoji"] | undefined}
+ * The first matching emoji entity, or `undefined` if none is found.
+ *
+ * @example
+ * const emoji = getEmoji(element);
+ * if (emoji) {
+ *     console.log(emoji.id);
+ * }
+ */
+export declare function getEmoji(element: IntrinsicElement): IntrinsicElements["emoji"] | undefined;
+//# sourceMappingURL=getEmoji.d.ts.map

package/dist/utils/getEmoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEmoji.d.ts","sourceRoot":"","sources":["../../src/utils/getEmoji.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAS1F"}

package/dist/utils/getEmoji.js

@@ -0,0 +1,33 @@
+/**
+ * Finds the first direct emoji intrinsic child entity within an element.
+ *
+ * This utility performs a shallow scan over the element's immediate
+ * `children` collection and returns the first child whose intrinsic
+ * entity type is `"emoji"`.
+ *
+ * Only direct children are inspected. Nested descendants inside child
+ * branches are not traversed.
+ *
+ * Useful for extracting decorative or semantic emoji metadata from
+ * JSX-generated intrinsic trees.
+ *
+ * @param {IntrinsicElement} element - The intrinsic element whose direct children should be scanned.
+ * @returns {IntrinsicElements["emoji"] | undefined}
+ * The first matching emoji entity, or `undefined` if none is found.
+ *
+ * @example
+ * const emoji = getEmoji(element);
+ * if (emoji) {
+ *     console.log(emoji.id);
+ * }
+ */
+export function getEmoji(element) {
+    const children = element.children;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        if (child.type === "intrinsic" && child.entity.type === "emoji") {
+            return child.entity;
+        }
+    }
+}
+//# sourceMappingURL=getEmoji.js.map

package/dist/utils/getEmoji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEmoji.js","sourceRoot":"","sources":["../../src/utils/getEmoji.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC,MAAoC,CAAC;QACtD,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/utils/getPlainText.d.ts

@@ -0,0 +1,23 @@
+import type { IntrinsicElement } from "~/types/jsx.types";
+/**
+ * Finds the first direct plain-text child value within an intrinsic element.
+ *
+ * This utility performs a shallow scan over the element's immediate
+ * `children` collection and returns the value of the first child whose
+ * node type is `"plain"`.
+ *
+ * Only direct children are inspected. Nested descendants are not traversed.
+ *
+ * Useful for extracting raw textual labels, captions, button titles,
+ * or other first-level plain text content from JSX-generated trees.
+ *
+ * @param {IntrinsicElement} element - The intrinsic element whose direct children should be scanned.
+ * @returns {string | undefined}
+ * The first plain-text child value, or `undefined` if no direct plain node exists.
+ *
+ * @example
+ * const text = getPlainText(buttonElement);
+ * // "Click me"
+ */
+export declare function getPlainText(element: IntrinsicElement): string | undefined;
+//# sourceMappingURL=getPlainText.d.ts.map

package/dist/utils/getPlainText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlainText.d.ts","sourceRoot":"","sources":["../../src/utils/getPlainText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAU1E"}

package/dist/utils/getPlainText.js

@@ -0,0 +1,30 @@
+/**
+ * Finds the first direct plain-text child value within an intrinsic element.
+ *
+ * This utility performs a shallow scan over the element's immediate
+ * `children` collection and returns the value of the first child whose
+ * node type is `"plain"`.
+ *
+ * Only direct children are inspected. Nested descendants are not traversed.
+ *
+ * Useful for extracting raw textual labels, captions, button titles,
+ * or other first-level plain text content from JSX-generated trees.
+ *
+ * @param {IntrinsicElement} element - The intrinsic element whose direct children should be scanned.
+ * @returns {string | undefined}
+ * The first plain-text child value, or `undefined` if no direct plain node exists.
+ *
+ * @example
+ * const text = getPlainText(buttonElement);
+ * // "Click me"
+ */
+export function getPlainText(element) {
+    const children = element.children;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        if (child.type === "plain") {
+            return child.value;
+        }
+    }
+}
+//# sourceMappingURL=getPlainText.js.map

package/dist/utils/getPlainText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlainText.js","sourceRoot":"","sources":["../../src/utils/getPlainText.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAyB;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,KAA2B,CAAC;QAC7C,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/utils/global.d.ts

@@ -0,0 +1,13 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { Message } from "~/types/grammy.types";
+import type { HookRuntime } from "~/types/hooks.types";
+import type { BotHandlerLifecycleInstance } from "~/types/lib.types";
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare const globalButtonCallbacks: Record<string, (ctx: ReactiveContext) => Promise<void> | void>;
+export declare const globalPreviousState: Record<string, Message>;
+export declare const globalCurrentState: Record<string, Message>;
+export declare const globalIdSet: Set<string>;
+export declare const globalAbortControllers: Map<string, AbortController>;
+export declare const globalHookRuntimeAsyncStorage: AsyncLocalStorage<HookRuntime>;
+export declare const globalStates: Map<string, BotHandlerLifecycleInstance<ReactiveContext>>;
+//# sourceMappingURL=global.d.ts.map

package/dist/utils/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../src/utils/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAM,CAAA;AACvG,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAA;AAC9D,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAA;AAC7D,eAAO,MAAM,WAAW,EAAE,GAAG,CAAC,MAAM,CAAa,CAAC;AAClD,eAAO,MAAM,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAa,CAAC;AAC9E,eAAO,MAAM,6BAA6B,gCAAuC,CAAC;AAClF,eAAO,MAAM,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAa,CAAC"}

package/dist/utils/global.js

@@ -0,0 +1,7 @@
+export const globalButtonCallbacks = {};
+export const globalHooks = {};
+export const globalPreviousState = {};
+export const globalCurrentState = {};
+export const globalIdSet = new Set();
+export const globalAbortControllers = new Map();
+//# sourceMappingURL=global.js.map

package/dist/utils/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/utils/global.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAmE,EAAE,CAAA;AACvG,MAAM,CAAC,MAAM,WAAW,GAA0B,EAAE,CAAA;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAA4B,EAAE,CAAA;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAA4B,EAAE,CAAA;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAgB,IAAI,GAAG,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAiC,IAAI,GAAG,EAAE,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { generateUniqueId } from "./generateUniqueId";
+export { isEmoji } from "./isEmoji";
+export { isUnixTime } from "./isUnixTime";
+export { sanitizeHtmlString } from "./sanitizeHtmlString";
+export { isIntrinsicElement } from "./isIntrinsicElement";
+export { getEmoji } from "./getEmoji";
+export { getPlainText } from "./getPlainText";
+export * from "./global";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+export { generateUniqueId } from "./generateUniqueId";
+export { isEmoji } from "./isEmoji";
+export { isUnixTime } from "./isUnixTime";
+export { sanitizeHtmlString } from "./sanitizeHtmlString";
+export { isIntrinsicElement } from "./isIntrinsicElement";
+export { getEmoji } from "./getEmoji";
+export { getPlainText } from "./getPlainText";
+export { isEqual } from "./isEqual";
+export * from "./global";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,cAAc,UAAU,CAAC"}

package/dist/utils/isAbortError.d.ts

@@ -0,0 +1,2 @@
+export declare function isAbortError(error: unknown): boolean;
+//# sourceMappingURL=isAbortError.d.ts.map

package/dist/utils/isAbortError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAbortError.d.ts","sourceRoot":"","sources":["../../src/utils/isAbortError.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD"}

package/dist/utils/isEmoji.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Checks whether a string is exactly one emoji symbol.
+ *
+ * The check validates that the entire string consists of a single
+ * Unicode RGI emoji grapheme, including complex emoji sequences such as:
+ * - skin tone modifiers
+ * - ZWJ sequences
+ * - flags
+ * - family emojis
+ * - keycap emojis
+ *
+ * Requires JavaScript support for the `v` regular expression flag.
+ *
+ * @param {string} str - The string to validate.
+ * @returns {boolean} `true` if the string is exactly one emoji symbol.
+ *
+ * @example
+ * isEmoji("🔥"); // true
+ * isEmoji("👨‍👩‍👧‍👦"); // true
+ * isEmoji("🇱🇻"); // true
+ * isEmoji("🔥🔥"); // false
+ * isEmoji("🔥 hi"); // false
+ */
+export declare function isEmoji(str: string): boolean;
+//# sourceMappingURL=isEmoji.d.ts.map

package/dist/utils/isEmoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEmoji.d.ts","sourceRoot":"","sources":["../../src/utils/isEmoji.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C"}

package/dist/utils/isEmoji.js

@@ -0,0 +1,27 @@
+/**
+ * Checks whether a string is exactly one emoji symbol.
+ *
+ * The check validates that the entire string consists of a single
+ * Unicode RGI emoji grapheme, including complex emoji sequences such as:
+ * - skin tone modifiers
+ * - ZWJ sequences
+ * - flags
+ * - family emojis
+ * - keycap emojis
+ *
+ * Requires JavaScript support for the `v` regular expression flag.
+ *
+ * @param {string} str - The string to validate.
+ * @returns {boolean} `true` if the string is exactly one emoji symbol.
+ *
+ * @example
+ * isEmoji("🔥"); // true
+ * isEmoji("👨‍👩‍👧‍👦"); // true
+ * isEmoji("🇱🇻"); // true
+ * isEmoji("🔥🔥"); // false
+ * isEmoji("🔥 hi"); // false
+ */
+export function isEmoji(str) {
+    return /^\p{RGI_Emoji}$/v.test(str);
+}
+//# sourceMappingURL=isEmoji.js.map

package/dist/utils/isEmoji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEmoji.js","sourceRoot":"","sources":["../../src/utils/isEmoji.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IAC/B,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/isEqual.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Performs a deep structural equality comparison between two values.
+ *
+ * This utility recursively compares primitives, arrays, plain objects,
+ * typed arrays, buffers, maps, sets, dates, regexes, symbols,
+ * array buffers, data views, and cyclic object graphs.
+ *
+ * Supported comparison features:
+ * - deep recursive object comparison
+ * - cyclic reference detection
+ * - `NaN` equality support
+ * - symbol key comparison
+ * - `Map` and `Set` structural equality
+ * - `ArrayBuffer`, `DataView`, and typed array byte comparison
+ * - `Buffer` support in Node.js
+ * - constructor equality validation
+ *
+ * `Set` values are compared by deep value equivalence rather than insertion
+ * identity, and `Map` values are compared through their entry pairs.
+ *
+ * @param {unknown} a - The first value to compare.
+ * @param {unknown} b - The second value to compare.
+ * @returns {boolean} `true` if both values are deeply equal, otherwise `false`.
+ *
+ * @example
+ * isEqual({ a: 1, b: [2, 3] }, { a: 1, b: [2, 3] });
+ * // true
+ *
+ * @example
+ * isEqual(new Set([1, 2]), new Set([2, 1]));
+ * // true
+ *
+ * @example
+ * const a: any = {};
+ * a.self = a;
+ * const b: any = {};
+ * b.self = b;
+ * isEqual(a, b);
+ * // true
+ */
+export declare function isEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=isEqual.d.ts.map

package/dist/utils/isEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEqual.d.ts","sourceRoot":"","sources":["../../src/utils/isEqual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAsFvD"}

package/dist/utils/isEqual.js

@@ -0,0 +1,142 @@
+/**
+ * Performs a deep structural equality comparison between two values.
+ *
+ * This utility recursively compares primitives, arrays, plain objects,
+ * typed arrays, buffers, maps, sets, dates, regexes, symbols,
+ * array buffers, data views, and cyclic object graphs.
+ *
+ * Supported comparison features:
+ * - deep recursive object comparison
+ * - cyclic reference detection
+ * - `NaN` equality support
+ * - symbol key comparison
+ * - `Map` and `Set` structural equality
+ * - `ArrayBuffer`, `DataView`, and typed array byte comparison
+ * - `Buffer` support in Node.js
+ * - constructor equality validation
+ *
+ * `Set` values are compared by deep value equivalence rather than insertion
+ * identity, and `Map` values are compared through their entry pairs.
+ *
+ * @param {unknown} a - The first value to compare.
+ * @param {unknown} b - The second value to compare.
+ * @returns {boolean} `true` if both values are deeply equal, otherwise `false`.
+ *
+ * @example
+ * isEqual({ a: 1, b: [2, 3] }, { a: 1, b: [2, 3] });
+ * // true
+ *
+ * @example
+ * isEqual(new Set([1, 2]), new Set([2, 1]));
+ * // true
+ *
+ * @example
+ * const a: any = {};
+ * a.self = a;
+ * const b: any = {};
+ * b.self = b;
+ * isEqual(a, b);
+ * // true
+ */
+export function isEqual(a, b) {
+    const toString = Object.prototype.toString;
+    const hasOwn = Object.prototype.hasOwnProperty;
+    const propertyIsEnumerable = Object.prototype.propertyIsEnumerable;
+    const eq = (x, y) => x === y || (x !== x && y !== y);
+    const isObjectLike = (v) => v !== null && typeof v === "object";
+    const isTypedArray = (v) => ArrayBuffer.isView(v) && !(v instanceof DataView);
+    const getTag = (v) => toString.call(v);
+    const getSymbols = (obj) => Object.getOwnPropertySymbols(obj).filter((s) => propertyIsEnumerable.call(obj, s));
+    const getAllKeys = (obj) => [...Object.keys(obj), ...getSymbols(obj)];
+    const compare = (x, y, stack = new WeakMap()) => {
+        if (eq(x, y))
+            return true;
+        if (!isObjectLike(x) || !isObjectLike(y))
+            return eq(x, y);
+        if (stack.get(x) === y)
+            return true;
+        stack.set(x, y);
+        const tagX = getTag(x), tagY = getTag(y);
+        if (tagX !== tagY)
+            return false;
+        if (Array.isArray(x)) {
+            if (x.length !== y.length)
+                return false;
+            for (let i = 0; i < x.length; i++)
+                if (!compare(x[i], y[i], stack))
+                    return false;
+            return true;
+        }
+        if (tagX === "[object Date]" || tagX === "[object Boolean]" || tagX === "[object Number]")
+            return eq(+x, +y);
+        if (tagX === "[object String]" || tagX === "[object RegExp]")
+            return String(x) === String(y);
+        if (tagX === "[object Error]")
+            return x.name === y.name && x.message === y.message;
+        if (tagX === "[object Symbol]")
+            return Symbol.prototype.valueOf.call(x) === Symbol.prototype.valueOf.call(y);
+        if (tagX === "[object ArrayBuffer]") {
+            if (x.byteLength !== y.byteLength)
+                return false;
+            return compare(new Uint8Array(x), new Uint8Array(y), stack);
+        }
+        if (tagX === "[object DataView]") {
+            if (x.byteLength !== y.byteLength || x.byteOffset !== y.byteOffset)
+                return false;
+            return compare(new Uint8Array(x.buffer), new Uint8Array(y.buffer), stack);
+        }
+        if (isTypedArray(x)) {
+            if (x.length !== y.length)
+                return false;
+            for (let i = 0; i < x.length; i++)
+                if (!eq(x[i], y[i]))
+                    return false;
+            return true;
+        }
+        if (tagX === "[object Set]") {
+            if (x.size !== y.size)
+                return false;
+            const used = new Set(), arrY = [...y];
+            outer: for (const xv of x) {
+                for (let i = 0; i < arrY.length; i++) {
+                    if (used.has(i))
+                        continue;
+                    if (compare(xv, arrY[i], stack)) {
+                        used.add(i);
+                        continue outer;
+                    }
+                }
+                return false;
+            }
+            return true;
+        }
+        if (tagX === "[object Map]") {
+            if (x.size !== y.size)
+                return false;
+            return compare([...x.entries()], [...y.entries()], stack);
+        }
+        if (typeof Buffer !== "undefined" && Buffer.isBuffer(x)) {
+            if (!Buffer.isBuffer(y) || x.length !== y.length)
+                return false;
+            for (let i = 0; i < x.length; i++)
+                if (x[i] !== y[i])
+                    return false;
+            return true;
+        }
+        const keysX = getAllKeys(x);
+        const keysY = getAllKeys(y);
+        if (keysX.length !== keysY.length)
+            return false;
+        for (const key of keysX) {
+            if (!hasOwn.call(y, key))
+                return false;
+            if (!compare(x[key], y[key], stack))
+                return false;
+        }
+        const ctorX = x.constructor;
+        const ctorY = y.constructor;
+        return ctorX === ctorY;
+    };
+    return compare(a, b);
+}
+//# sourceMappingURL=isEqual.js.map

package/dist/utils/isEqual.js.map

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