grambot 1.0.0

package/dist/menu/button.js

@@ -0,0 +1,157 @@
+/**
+ * Fluent builder for a single inline button.
+ *
+ * Usage (from LayoutBuilder):
+ * ```ts
+ * layout.button("Label")
+ *   .id("unique")
+ *   .row()
+ *   .guard(ctx => ctx.user.isAdmin)
+ *   .action(someAction)
+ * ```
+ */
+export class ButtonBuilder {
+    /** @internal */
+    _config;
+    /**
+     * @internal Use `layout.button()` instead.
+     */
+    constructor(label) {
+        this._config = {
+            label,
+            forceRow: false,
+            isDefault: false,
+        };
+    }
+    /**
+     * Set a stable callback-data identifier for this button.
+     * If not set, one will be generated automatically.
+     */
+    id(value) {
+        this._config.buttonId = value;
+        return this;
+    }
+    /**
+     * Set a URL for this button. Turns it into a URL button.
+     */
+    url(value) {
+        this._config.url = value;
+        return this;
+    }
+    /**
+     * Force this button onto a new row in the keyboard.
+     */
+    row() {
+        this._config.forceRow = true;
+        return this;
+    }
+    /**
+     * Only show this button if the guard returns true.
+     * @param fn - A synchronous or asynchronous guard function.
+     */
+    guard(fn) {
+        this._config.guard = fn;
+        return this;
+    }
+    /**
+     * Attach an action handler.
+     *
+     * Accepts:
+     * - An `ActionRef` (created via `Grambot.action`)
+     * - An inline async/sync function
+     * - A simple `() => void` for client-side only changes? (No, usually needs context)
+     *
+     * @param handler - The handler to execute on click.
+     */
+    action(handler) {
+        if (typeof handler === "function") {
+            if (handler.constructor.name === "AsyncFunction") {
+                this._config.inlineHandler = handler;
+                this._config.action = undefined;
+            }
+            else {
+                this._config.action = handler;
+                this._config.inlineHandler = undefined;
+            }
+        }
+        else {
+            this._config.action = handler;
+            this._config.inlineHandler = undefined;
+        }
+        return this;
+    }
+    /**
+     * Open a sub-menu when this button is pressed.
+     * @param ref - The menu reference to open.
+     */
+    menu(ref) {
+        this._config.submenu = ref;
+        return this;
+    }
+    /**
+     * Attach a typed payload to this button.
+     * The payload is serialized into the callback data and passed to the action.
+     */
+    payload(data) {
+        this._config.payload = data;
+        return this;
+    }
+    /**
+     * Mark this button as the default inside its menu.
+     * Default buttons are triggered if the user sends text that doesn't match any other button.
+     */
+    default() {
+        this._config.isDefault = true;
+        return this;
+    }
+    /**
+     * Set a color style for this button.
+     * Available styles: "danger" (red), "success" (green), "primary" (blue).
+     * Requires Telegram Bot API 9.4+ (supported in Telegram clients from Feb 2026).
+     */
+    style(value) {
+        this._config.style = value;
+        return this;
+    }
+    /**
+     * Shorthand for `.style("danger")` — renders a red button.
+     * Ideal for destructive actions like delete, ban, cancel.
+     */
+    danger() {
+        return this.style("danger");
+    }
+    /**
+     * Shorthand for `.style("success")` — renders a green button.
+     * Ideal for confirmations like confirm, pay, accept.
+     */
+    success() {
+        return this.style("success");
+    }
+    /**
+     * Shorthand for `.style("primary")` — renders a blue button.
+     * Ideal for primary/highlighted actions.
+     */
+    primary() {
+        return this.style("primary");
+    }
+    /**
+     * Set a custom emoji icon to display before the button text.
+     * The custom emoji must be owned by the bot's owner (Premium).
+     * Requires Telegram Bot API 9.4+.
+     * @param customEmojiId - Unique identifier of the custom emoji.
+     */
+    icon(customEmojiId) {
+        this._config.iconCustomEmojiId = customEmojiId;
+        return this;
+    }
+}
+/**
+ * Check if a value is an ActionRef.
+ * @internal
+ */
+export function isActionRef(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__Grambot_action === true);
+}
+//# sourceMappingURL=button.js.map

package/dist/menu/button.js.map

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

package/dist/menu/layout.d.ts

@@ -0,0 +1,86 @@
+import type { LayoutBuilderInterface, DynamicLabel, ButtonBuilderInterface, ListBuilderInterface, TextBuilderInterface, ButtonActionHandler, ParseMode } from "../types.js";
+import { ButtonBuilder } from "./button.js";
+import { ListBuilder } from "./list.js";
+/**
+ * Describes one element inside the layout (text, button, list, refresh-button).
+ * @internal
+ */
+export type LayoutElement = {
+    kind: "text";
+    content: string;
+    parseMode?: ParseMode;
+    replace?: Record<string, any>;
+} | {
+    kind: "image";
+    url: string;
+} | {
+    kind: "button";
+    builder: ButtonBuilder;
+} | {
+    kind: "list";
+    builder: ListBuilder<any>;
+} | {
+    kind: "refresh";
+    label: string;
+};
+/**
+ * LayoutBuilder — the DSL object passed to `Grambot.menu(layout => { ... })`.
+ *
+ * Collects declarative descriptions and stores them. The engine
+ * later compiles these into real Grammy inline keyboards and handlers.
+ */
+export declare class LayoutBuilder implements LayoutBuilderInterface {
+    /** @internal */
+    readonly _elements: LayoutElement[];
+    /** @internal */
+    _currentText: string;
+    /** @internal */
+    _maxPerRow: number;
+    /**
+     * Set the message text above the keyboard.
+     * If called multiple times, appends to the previous text.
+     * @param content - The text content.
+     */
+    text(content: string): TextBuilderInterface;
+    /**
+     * Set the menu header image.
+     * @param url - The image URL.
+     */
+    image(url: string): void;
+    /**
+     * Create a button.
+     * @param label - A static string or a dynamic `(ctx) => string` function.
+     */
+    button(label: DynamicLabel): ButtonBuilderInterface;
+    /**
+     * Create a paginated list of items.
+     * @param items - Array of items to display.
+     * @param action - Optional default action for items.
+     */
+    list<T>(items: T[], action?: ButtonActionHandler): ListBuilderInterface<T>;
+    /**
+     * Maximum number of buttons per row in the final keyboard.
+     * 0 (default) means no limit.
+     */
+    maxPerRow(count: number): void;
+    /**
+     * Add a "refresh" button that re-renders the current menu.
+     * @param label - Button label (e.g., "🔄 Refresh").
+     */
+    refreshButton(label: string): void;
+}
+/**
+ * Helper for configuring message text (e.g., parse mode).
+ * @internal
+ */
+export declare class TextBuilder implements TextBuilderInterface {
+    private element;
+    constructor(element: Extract<LayoutElement, {
+        kind: "text";
+    }>);
+    /** Set the parse mode for this text block. */
+    parseAs(mode: ParseMode): TextBuilderInterface;
+    /** Set interpolation variables for the text */
+    replace(data: Record<string, any>): TextBuilderInterface;
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/menu/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/menu/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAM;IACzC,gBAAgB;IAChB,YAAY,SAAM;IAClB,gBAAgB;IAChB,UAAU,SAAK;IAEf;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;IAO3C;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB;IAMnD;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,CAAC,CAAC;IAO1E;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,oBAAoB;IAC1C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAErE,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,oBAAoB;IAK9C,+CAA+C;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAIzD"}

package/dist/menu/layout.js

@@ -0,0 +1,90 @@
+import { ButtonBuilder } from "./button.js";
+import { ListBuilder } from "./list.js";
+/**
+ * LayoutBuilder — the DSL object passed to `Grambot.menu(layout => { ... })`.
+ *
+ * Collects declarative descriptions and stores them. The engine
+ * later compiles these into real Grammy inline keyboards and handlers.
+ */
+export class LayoutBuilder {
+    /** @internal */
+    _elements = [];
+    /** @internal */
+    _currentText = "";
+    /** @internal */
+    _maxPerRow = 0; // 0 = no limit
+    /**
+     * Set the message text above the keyboard.
+     * If called multiple times, appends to the previous text.
+     * @param content - The text content.
+     */
+    text(content) {
+        this._currentText = content;
+        const element = { kind: "text", content };
+        this._elements.push(element);
+        return new TextBuilder(element);
+    }
+    /**
+     * Set the menu header image.
+     * @param url - The image URL.
+     */
+    image(url) {
+        this._elements.push({ kind: "image", url });
+    }
+    /**
+     * Create a button.
+     * @param label - A static string or a dynamic `(ctx) => string` function.
+     */
+    button(label) {
+        const builder = new ButtonBuilder(label);
+        this._elements.push({ kind: "button", builder });
+        return builder;
+    }
+    /**
+     * Create a paginated list of items.
+     * @param items - Array of items to display.
+     * @param action - Optional default action for items.
+     */
+    list(items, action) {
+        const builder = new ListBuilder(items);
+        if (action)
+            builder.action(action);
+        this._elements.push({ kind: "list", builder });
+        return builder;
+    }
+    /**
+     * Maximum number of buttons per row in the final keyboard.
+     * 0 (default) means no limit.
+     */
+    maxPerRow(count) {
+        this._maxPerRow = count;
+    }
+    /**
+     * Add a "refresh" button that re-renders the current menu.
+     * @param label - Button label (e.g., "🔄 Refresh").
+     */
+    refreshButton(label) {
+        this._elements.push({ kind: "refresh", label });
+    }
+}
+/**
+ * Helper for configuring message text (e.g., parse mode).
+ * @internal
+ */
+export class TextBuilder {
+    element;
+    constructor(element) {
+        this.element = element;
+    }
+    /** Set the parse mode for this text block. */
+    parseAs(mode) {
+        this.element.parseMode = mode;
+        return this;
+    }
+    /** Set interpolation variables for the text */
+    replace(data) {
+        this.element.replace = data;
+        return this;
+    }
+}
+//# sourceMappingURL=layout.js.map

package/dist/menu/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/menu/layout.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAaxC;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB,gBAAgB;IACP,SAAS,GAAoB,EAAE,CAAC;IACzC,gBAAgB;IAChB,YAAY,GAAG,EAAE,CAAC;IAClB,gBAAgB;IAChB,UAAU,GAAG,CAAC,CAAC,CAAC,eAAe;IAE/B;;;;OAIG;IACH,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,MAAM,OAAO,GAA6C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACpF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAmB;QACxB,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAI,KAAU,EAAE,MAA4B;QAC9C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAI,KAAK,CAAC,CAAC;QAC1C,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,OAAiD;QAAjD,YAAO,GAAP,OAAO,CAA0C;IAAG,CAAC;IAEzE,8CAA8C;IAC9C,OAAO,CAAC,IAAe;QACrB,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAC,IAAyB;QAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/menu/list.d.ts

@@ -0,0 +1,43 @@
+import type { ListConfig, ListBuilderInterface, ButtonBuilderInterface, ButtonActionHandler } from "../types.js";
+/**
+ * Fluent builder for a paginated, dynamic list of items rendered as buttons.
+ *
+ * Usage (from LayoutBuilder):
+ * ```ts
+ * layout.list(items)
+ *   .perPage(5)
+ *   .columns(1)
+ *   .render(item => layout.button(`⭐ ${item.title}`).payload(...).action(...))
+ * ```
+ */
+export declare class ListBuilder<T> implements ListBuilderInterface<T> {
+    /** @internal */
+    readonly _config: ListConfig<T>;
+    /**
+     * @internal Use `layout.list()` instead.
+     */
+    constructor(items: T[]);
+    /**
+     * Set the number of items to show per page.
+     * Default is 10.
+     */
+    perPage(count: number): this;
+    /**
+     * Set the number of columns (buttons per row) for the list items.
+     * Default is 1.
+     */
+    columns(count: number): this;
+    /**
+     * Set the render callback — called once per visible item on the current page.
+     *
+     * The callback must return a {@link ButtonBuilderInterface}.
+     * @param fn - A function that returns a button builder for each item.
+     */
+    render(fn: (item: T) => ButtonBuilderInterface): void;
+    /**
+     * Set the default action for items in this list.
+     * @param handler - The action handler or reference.
+     */
+    action(handler: ButtonActionHandler): this;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/menu/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/menu/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;GAUG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,oBAAoB,CAAC,CAAC,CAAC;IAC5D,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAEhC;;OAEG;gBACS,KAAK,EAAE,CAAC,EAAE;IAStB;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,sBAAsB,GAAG,IAAI;IAIrD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;CAI3C"}

package/dist/menu/list.js

@@ -0,0 +1,60 @@
+/**
+ * Fluent builder for a paginated, dynamic list of items rendered as buttons.
+ *
+ * Usage (from LayoutBuilder):
+ * ```ts
+ * layout.list(items)
+ *   .perPage(5)
+ *   .columns(1)
+ *   .render(item => layout.button(`⭐ ${item.title}`).payload(...).action(...))
+ * ```
+ */
+export class ListBuilder {
+    /** @internal */
+    _config;
+    /**
+     * @internal Use `layout.list()` instead.
+     */
+    constructor(items) {
+        this._config = {
+            items,
+            itemsPerPage: 10,
+            columns: 1,
+            renderFn: undefined,
+        };
+    }
+    /**
+     * Set the number of items to show per page.
+     * Default is 10.
+     */
+    perPage(count) {
+        this._config.itemsPerPage = count;
+        return this;
+    }
+    /**
+     * Set the number of columns (buttons per row) for the list items.
+     * Default is 1.
+     */
+    columns(count) {
+        this._config.columns = count;
+        return this;
+    }
+    /**
+     * Set the render callback — called once per visible item on the current page.
+     *
+     * The callback must return a {@link ButtonBuilderInterface}.
+     * @param fn - A function that returns a button builder for each item.
+     */
+    render(fn) {
+        this._config.renderFn = fn;
+    }
+    /**
+     * Set the default action for items in this list.
+     * @param handler - The action handler or reference.
+     */
+    action(handler) {
+        this._config.action = handler;
+        return this;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/menu/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/menu/list.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACtB,gBAAgB;IACP,OAAO,CAAgB;IAEhC;;OAEG;IACH,YAAY,KAAU;QACpB,IAAI,CAAC,OAAO,GAAG;YACb,KAAK;YACL,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,SAAS;SACpB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAuC;QAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAA4B;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/menu/menu.d.ts

@@ -0,0 +1,29 @@
+import type { LayoutBuilderInterface, MenuRef, GrambotContext } from "../types.js";
+import { LayoutBuilder } from "./layout.js";
+export { LayoutBuilder } from "./layout.js";
+export { ButtonBuilder } from "./button.js";
+export { ListBuilder } from "./list.js";
+/**
+ * Returns all menus created via createMenu().
+ * @internal
+ */
+export declare function getGlobalMenus(): MenuRef[];
+/**
+ * Creates a MenuRef — a serializable reference to a menu definition.
+ *
+ * The builder function is stored and will be called when the menu
+ * needs to be rendered (at compile time or on refresh).
+ *
+ * @param builder - A function that defines the menu layout.
+ * @param options - Optional configuration like a fixed manual ID.
+ * @returns A {@link MenuRef} object.
+ */
+export declare function createMenu(builder: (layout: LayoutBuilderInterface, ctx: GrambotContext) => void | Promise<void>, options?: {
+    id?: string;
+}): MenuRef;
+/**
+ * Compile a MenuRef into a LayoutBuilder (runs the builder function).
+ * @internal
+ */
+export declare function compileMenu(ref: MenuRef, ctx: GrambotContext): Promise<LayoutBuilder>;
+//# sourceMappingURL=menu.d.ts.map

package/dist/menu/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/menu/menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,OAAO,EACP,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACtF,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAqCT;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAI3F"}

package/dist/menu/menu.js

@@ -0,0 +1,73 @@
+import { randomUUID } from "node:crypto";
+import { LayoutBuilder } from "./layout.js";
+export { LayoutBuilder } from "./layout.js";
+export { ButtonBuilder } from "./button.js";
+export { ListBuilder } from "./list.js";
+const globalMenus = new Set();
+/**
+ * Returns all menus created via createMenu().
+ * @internal
+ */
+export function getGlobalMenus() {
+    return Array.from(globalMenus);
+}
+/**
+ * Creates a MenuRef — a serializable reference to a menu definition.
+ *
+ * The builder function is stored and will be called when the menu
+ * needs to be rendered (at compile time or on refresh).
+ *
+ * @param builder - A function that defines the menu layout.
+ * @param options - Optional configuration like a fixed manual ID.
+ * @returns A {@link MenuRef} object.
+ */
+export function createMenu(builder, options) {
+    const ref = {
+        __Grambot_menu: true,
+        id: options?.id ?? `m${randomUUID().slice(0, 6)}`,
+        builder,
+        triggers: {},
+        /**
+         * Add a command trigger to open this menu.
+         * @param name - Command name (e.g., "start").
+         */
+        command(name) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.commands = [...(this.triggers.commands || []), name];
+            return this;
+        },
+        /**
+         * Add a word/phrase trigger to open this menu.
+         * @param text - Exact text to match.
+         */
+        word(text) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.words = [...(this.triggers.words || []), text];
+            return this;
+        },
+        /**
+         * Add a regex trigger to open this menu.
+         * @param pattern - Regular expression to match.
+         */
+        regexp(pattern) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.regexps = [...(this.triggers.regexps || []), pattern];
+            return this;
+        },
+    };
+    globalMenus.add(ref);
+    return ref;
+}
+/**
+ * Compile a MenuRef into a LayoutBuilder (runs the builder function).
+ * @internal
+ */
+export async function compileMenu(ref, ctx) {
+    const layout = new LayoutBuilder();
+    await ref.builder(layout, ctx);
+    return layout;
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/menu/menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAW,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,OAAsF,EACtF,OAAyB;IAEzB,MAAM,GAAG,GAAY;QACnB,cAAc,EAAE,IAAI;QACpB,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACjD,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ;;;WAGG;QACH,OAAO,CAAC,IAAY;YAClB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;QACD;;;WAGG;QACH,IAAI,CAAC,IAAY;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QACD;;;WAGG;QACH,MAAM,CAAC,OAAe;YACpB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY,EAAE,GAAmB;IACjE,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;IACnC,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC"}