telekit 2.2.0a3__tar.gz → 2.3.0__tar.gz

{telekit-2.2.0a3/telekit.egg-info → telekit-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.2.0a3
+Version: 2.3.0
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -77,7 +77,7 @@ Telekit comes with a [built-in DSL](https://github.com/Romashkaa/telekit/blob/ma
 
 > See the [full example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
 
-Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, built-in emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
+Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, a built-in declarative calendar picker, emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
 
 **Key features:**  
 - Declarative bot logic with **chains** for effortless handling of complex conversations
@@ -85,6 +85,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Automatic handling of [message formatting](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/6_styles.md) via [Sender](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/5_senders.md) and **callback routing**
 - **Deep Linking** support with type-checked [Command Parameters](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/command_trigger_parameters.md) for flexible user input
 - Built-in **Permission** and **Logging** system for user management
+- Reusable **Traits** system for pluggable, self-contained behavior modules
 - Seamless integration with [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)
 - Fast to develop and easy-to-extend code
 
@@ -101,7 +102,8 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
     - [Dialogue](https://github.com/Romashkaa/telekit/blob/main/docs/examples/dialogue.md)
     - [Risk Game](https://github.com/Romashkaa/telekit/blob/main/docs/examples/risk_game.md)
     - [Counter](https://github.com/Romashkaa/telekit/blob/main/docs/examples/counter.md)
-    - [Quiz (Telekit DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Quiz (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Hotel (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md)
     - [More...](https://github.com/Romashkaa/telekit/blob/main/docs/examples/examples.md)
 
 ## Overview
@@ -347,6 +349,42 @@ telekit.Server(BOT_TOKEN).polling()
 
 You can find a [full quiz example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md) and [DSL reference](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial/11_telekit_dsl.md) in the repository.
 
+### Traits
+
+Traits are reusable behavior modules you can mix into any handler.
+
+This example demonstrates the simplest way to use the built-in CalendarPick trait. It allows a user to pick a date from an inline calendar and handles the result via a callback.
+
+```py
+from telekit.traits import CalendarPick
+
+class CalendarHandler(CalendarPick, telekit.Handler):
+
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.command("calendar").invoke(cls.handle)
+
+    def handle(self) -> None:
+        self.chain.sender.set_title("📅 Choose a date")
+        self.chain.sender.set_message("Select any date — past or future:")
+        self.chain.sender.set_remove_text(False)
+
+        self.calendar_pick(self.handle_date) # HERE
+
+    def handle_date(self, date: datetime.date) -> None:
+        self.chain.sender.set_text(f"You picked: {date}")
+        self.chain.send()
+```
+
+<details>
+  <summary>Result</summary>
+  <table>
+    <tr>
+      <td><img src="./docs/images/calendar.png" alt="Telekit Calendar Example" width="500"></td>
+    </tr>
+  </table>
+</details>
+
 ### Example Bot
 
 You can launch an example bot by **running the following code**:
@@ -367,6 +405,7 @@ It includes example commands, dialogs, keyboards, and style usage.
 - **Styles API** for rich text (`Bold`, `Italic`, `Links`) with **automatic escaping**.
 - Deep linking and **typed command parameters**.
 - **Built-in DSL** for menus, FAQs, and simple bots.
+- Reusable **Traits** for composable, plug-and-play behavior (for example, a built-in declarative calendar picker).
 - **Zero-code** [Obsidian Canvas](https://github.com/Romashkaa/telekit/blob/main/docs/examples/canvas_faq.md) mode.
 - Seamless integration with **pyTelegramBotAPI**.
 
@@ -378,49 +417,6 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.2.0a3
-
-## New Button Types
-
-| **Name**             | **Description**                                          |
-|----------------------|----------------------------------------------------------|
-| `AlertButton`        | A callback button that shows a popup alert when pressed. |
-| `NotificationButton` | A callback button that shows a notification.             |
-| `InvokeButton`       | A callback button that calls the object method.          |
-
-## User Improvements
-
-| **Name**               | **Description**                                           |
-| ---------------------- | --------------------------------------------------------- |
-| `bio`                  | Bio of the user or description of the chat.               |
-| `birthdate`            | Birthdate of the user, if set and visible.                |
-| `description`          | Description of the group or channel.                      |
-| `mention`              | `tg://user?id=` deep link, works even without a username. |
-| `is_private`           | Whether the message was sent in a private chat.           |
-| `is_group`             | Whether the message was sent in a group.                  |
-| `is_supergroup`        | Whether the message was sent in a supergroup.             |
-| `is_channel`           | Whether the message was sent in a channel.                |
-| `avatar`               | File ID of the user's most recent profile photo.          |
-| `profile_photos_count` | Total number of profile photos the user has set.          |
-
-- Refactor: `User` now accepts a `Message` object instead of `chat_id` + `from_user`. All properties are derived from `_sender` (`from_user` or `chat`) and migrated to `cached_property`. Fixed broken `get_id` and `get_full_name` references.
-- Added `__repr__`.
-
-## Sender Improvements
-
-| **Name**                   | **Description**                                        |
-| -------------------------- | ------------------------------------------------------ |
-| `sent_message`             | The last message sent by this sender instance.         |
-| `disable_notification`     | Disables notification sound when the message is sent.  |
-| `protect_content`          | Protects the message contents from forwarding and saving. |
-| `reply_parameters`         | Reply parameters for the message to be sent.           |
-| `link_preview_options`     | Link preview options for the message to be sent.       |
-| `show_caption_above_media` | Shows the caption above the media instead of below.    |
-
-- Refactored sending system.
-
-## Chain Improvements
+# Changes in version 2.3.0
 
-| **Name**    | **Description**                                              |
-| ----------- | ------------------------------------------------------------ |
-| `received`  | The message received from the user during entry processing.  |
+[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)

{telekit-2.2.0a3 → telekit-2.3.0}/README.md

@@ -41,7 +41,7 @@ Telekit comes with a [built-in DSL](https://github.com/Romashkaa/telekit/blob/ma
 
 > See the [full example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
 
-Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, built-in emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
+Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, a built-in declarative calendar picker, emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
 
 **Key features:**  
 - Declarative bot logic with **chains** for effortless handling of complex conversations
@@ -49,6 +49,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Automatic handling of [message formatting](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/6_styles.md) via [Sender](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/5_senders.md) and **callback routing**
 - **Deep Linking** support with type-checked [Command Parameters](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/command_trigger_parameters.md) for flexible user input
 - Built-in **Permission** and **Logging** system for user management
+- Reusable **Traits** system for pluggable, self-contained behavior modules
 - Seamless integration with [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)
 - Fast to develop and easy-to-extend code
 
@@ -65,7 +66,8 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
     - [Dialogue](https://github.com/Romashkaa/telekit/blob/main/docs/examples/dialogue.md)
     - [Risk Game](https://github.com/Romashkaa/telekit/blob/main/docs/examples/risk_game.md)
     - [Counter](https://github.com/Romashkaa/telekit/blob/main/docs/examples/counter.md)
-    - [Quiz (Telekit DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Quiz (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Hotel (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md)
     - [More...](https://github.com/Romashkaa/telekit/blob/main/docs/examples/examples.md)
 
 ## Overview
@@ -311,6 +313,42 @@ telekit.Server(BOT_TOKEN).polling()
 
 You can find a [full quiz example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md) and [DSL reference](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial/11_telekit_dsl.md) in the repository.
 
+### Traits
+
+Traits are reusable behavior modules you can mix into any handler.
+
+This example demonstrates the simplest way to use the built-in CalendarPick trait. It allows a user to pick a date from an inline calendar and handles the result via a callback.
+
+```py
+from telekit.traits import CalendarPick
+
+class CalendarHandler(CalendarPick, telekit.Handler):
+
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.command("calendar").invoke(cls.handle)
+
+    def handle(self) -> None:
+        self.chain.sender.set_title("📅 Choose a date")
+        self.chain.sender.set_message("Select any date — past or future:")
+        self.chain.sender.set_remove_text(False)
+
+        self.calendar_pick(self.handle_date) # HERE
+
+    def handle_date(self, date: datetime.date) -> None:
+        self.chain.sender.set_text(f"You picked: {date}")
+        self.chain.send()
+```
+
+<details>
+  <summary>Result</summary>
+  <table>
+    <tr>
+      <td><img src="./docs/images/calendar.png" alt="Telekit Calendar Example" width="500"></td>
+    </tr>
+  </table>
+</details>
+
 ### Example Bot
 
 You can launch an example bot by **running the following code**:
@@ -331,6 +369,7 @@ It includes example commands, dialogs, keyboards, and style usage.
 - **Styles API** for rich text (`Bold`, `Italic`, `Links`) with **automatic escaping**.
 - Deep linking and **typed command parameters**.
 - **Built-in DSL** for menus, FAQs, and simple bots.
+- Reusable **Traits** for composable, plug-and-play behavior (for example, a built-in declarative calendar picker).
 - **Zero-code** [Obsidian Canvas](https://github.com/Romashkaa/telekit/blob/main/docs/examples/canvas_faq.md) mode.
 - Seamless integration with **pyTelegramBotAPI**.
 

{telekit-2.2.0a3 → telekit-2.3.0}/setup.py

@@ -28,8 +28,7 @@ def readme():
         return f.read()
   
 def changelog():
-    with open('CHANGELOG.md', 'r') as f:
-        return f.read()
+    return f"[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)"
 
 def install_requires():
     with open('telekit/requirements.txt', 'r') as f:

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/__init__.py

@@ -18,6 +18,7 @@
 # 
 
 from ._handler import Handler
+from ._trait import Trait
 from ._chain import Chain
 from ._callback_query_handler import CallbackQueryHandler
 from .server import Server, example
@@ -35,12 +36,15 @@ from . import parameters
 from . import inline_buttons
 from . import dices
 from . import utils
+from . import traits
+from . import debug
 
 Styles = styles.Styles
 
 from ._version import __version__
     
 __all__ = [
+    "traits",
     "utils",
     "senders", 
     "types",
@@ -54,6 +58,7 @@ __all__ = [
 
     "Server", 
     "Chain", 
+    "Trait",
     "Handler", 
     "CallbackQueryHandler",
 
@@ -64,4 +69,5 @@ __all__ = [
     "enable_file_logging",
     "chapters",
     "example",
+    "debug",
 ]

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_callback_query_handler.py

@@ -40,15 +40,17 @@ class CallbackQueryHandler:
             bot (TeleBot): The Telegram bot instance to be used for sending messages.
         """
         cls.bot = bot
-        cls.user_button_callbacks: dict[int, dict[str, Callable[[telebot.types.CallbackQuery], None]]] = {}
+        cls.user_button_callbacks: dict[int, dict[str, Callable[[CallbackQuery], None]]] = {}
 
         @bot.callback_query_handler(func=lambda call: True)
-        def handle(call: telebot.types.CallbackQuery) -> None:
+        def handle(call: CallbackQuery) -> None:
             if not call.data:
                 return
             
             if call.data.startswith(cls.INLINE_BUTTON):
                 cls._handle_inline_button(call)
+            elif call.data.startswith(cls.STATIC_BUTTON):
+                cls._handle_static_button(call)
             elif call.data.startswith(cls.SUGGEST):
                 cls._handle_suggestion(call)
             else:
@@ -59,7 +61,7 @@ class CallbackQueryHandler:
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
     @classmethod
-    def _handle_inline_button(cls, call: telebot.types.CallbackQuery):
+    def _handle_inline_button(cls, call: CallbackQuery):
         if not call.data:
             cls.bot.answer_callback_query(call.id, text=cls._invalid_data_answer[0], show_alert=cls._invalid_data_answer[1])
             return
@@ -76,10 +78,19 @@ class CallbackQueryHandler:
             cls.bot.answer_callback_query(call.id, text=cls._button_is_no_active_answer[0], show_alert=cls._button_is_no_active_answer[1])
             return
 
-        cls.remove_user_button_callbacks(call.from_user.id)
+        if not getattr(callback, "_persistent", False):
+            cls.remove_user_button_callbacks(call.from_user.id)
         
         callback(call)
 
+    # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+    # Static Buttons Handling
+    # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+
+    @classmethod
+    def _handle_static_button(cls, call: CallbackQuery):
+        cls.bot.answer_callback_query(call.id, text="")
+
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
     # Suggestion Handling
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
@@ -87,7 +98,7 @@ class CallbackQueryHandler:
     @classmethod
     def _handle_suggestion(cls, call: CallbackQuery):
         text: str = str(call.data)[len(cls.SUGGEST):]
-        cls.simulate(call.message, text, from_user=call.from_user)
+        cls.simulate(call.message, text, from_user=call.from_user) # pyright: ignore[reportArgumentType]
         cls.bot.answer_callback_query(call.id)
 
     @classmethod
@@ -126,9 +137,10 @@ class CallbackQueryHandler:
     # Query Types
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
+    STATIC_BUTTON: str = "static_button"
     INLINE_BUTTON: str = "inline_button:"
     SUGGEST: str = "suggest:"
-
+    
     @classmethod
     def suggest(cls, suggestion: str):
         return f"{cls.SUGGEST}{suggestion}"

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_chain.py

@@ -26,6 +26,7 @@ from telebot.types import Message
 
 # Local modules
 from . import senders
+from .debug import Debug
 from .styles import TextEntity
 
 # Chain modules
@@ -154,7 +155,7 @@ class Chain(ChainInlineKeyboardLogic, ChainEntryLogic):
         self.sender.set_edit_message(None)
         self._previous_message = message
 
-        if self._timeout_warnings_enabled and _handler and not _timeout:
+        if Debug.timeout_warnings and _handler and not _timeout:
             library.warning(
                 "Next-message handler is active, but no timeout was set for the chain. "
                 "This may cause the bot to wait indefinitely."

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_chain_base.py

@@ -31,14 +31,13 @@ from . import _input_handler
 from . import _timeout
 
 # Logging
+from .debug import Debug
 from ._logger import logger
 library = logger.library
 
 class ChainBase:
 
     bot: telebot.TeleBot
-
-    _timeout_warnings_enabled: bool = True
     
     @classmethod
     def _init(cls, bot: telebot.TeleBot):
@@ -206,4 +205,5 @@ class ChainBase:
     # Timeout API
 
     def disable_timeout_warnings(self, value: bool = True) -> None:
-        self._timeout_warnings_enabled = not value
+        """.. deprecated:: Set ``Debug.timeout_warnings`` directly."""
+        Debug.timeout_warnings = not value

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_chain_inline_keyboards_logic.py

@@ -40,8 +40,7 @@ if typing.TYPE_CHECKING:
 class ChainInlineKeyboardLogic(ChainBase):
     def set_inline_keyboard(
             self, 
-            keyboard: dict[str, Callable[[], Any] | InlineButton | str], 
-            *,
+            keyboard: dict[str, Any], 
             row_width: int | Iterable[int] = 1
         ) -> None:
         """
@@ -118,7 +117,6 @@ class ChainInlineKeyboardLogic(ChainBase):
     def inline_keyboard[Caption: str, Value](
             self, 
             keyboard: dict[Caption, Value],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> Callable[[Callable[[Value], None]], None]:
@@ -183,7 +181,6 @@ class ChainInlineKeyboardLogic(ChainBase):
     def inline_choice(
             self, 
             choices: list[Any] | tuple[Any, ...] | dict[str, Any | InlineButton],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> Callable[[Callable[[Any], None]], None]:
@@ -219,7 +216,6 @@ class ChainInlineKeyboardLogic(ChainBase):
             self,
             func: Callable[[Any], None],
             choices: list[Any] | tuple[Any, ...] | dict[str, Any | InlineButton],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> None:

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_handler.py

@@ -225,9 +225,16 @@ class Handler:
         
         handler_instance = handler(self.message)
         handler_instance.chain._set_previous_message(self.chain.get_previous_message())
+        handler_instance._on_handoff(self)
         
         return handler_instance
     
+
+    def _on_handoff(self, origin: "Handler") -> None:
+        """Called when this handler is reached via handoff(). Override to customize."""
+        pass
+    
+
     def freeze(self, func, *args):
         """
         Return a zero-argument callback that invokes the given function

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_init.py

@@ -31,7 +31,7 @@ import telebot
 __all__ = ["init"]
 
 def init(bot: telebot.TeleBot) -> None:
-    TelekitState.init(bot)
+    TelekitState._init(bot)
     BaseSender._init(bot)
     Handler._init(bot)
     Chain._init(bot)

{telekit-2.2.0a3 → telekit-2.3.0}/telekit/_inline_buttons.py

@@ -26,14 +26,18 @@ from telebot.types import InlineKeyboardButton, CallbackQuery
 from telebot import TeleBot
 from ._callback_query_handler import CallbackQueryHandler
 
+from ._state import TelekitState
+
 __all__ = [
-    "InlineButton", 
+    "InlineButton",
 
+    "StaticButton",
     "LinkButton", 
     "WebAppButton", 
     "SuggestButton",
     "CopyTextButton",
     "CallbackButton",
+    "AnswerButton",
     "AlertButton",
     "NotificationButton",
     "InvokeButton",
@@ -57,9 +61,11 @@ class InlineButton:
     - `SuggestButton`
     - `CopyTextButton`
     - `CallbackButton`
-    - `AlertButton`
-    - `NotificationButton`
-    - `InvokeButton`
+        - `InvokeButton`
+        - `AnswerButton`
+            - `AlertButton`
+            - `NotificationButton`
+    - `StaticButton`
     """
 
     _bot: TeleBot
@@ -70,12 +76,14 @@ class InlineButton:
 
     MAX_SIZE: int | None = None
     MIN_SIZE: int | None = None
-
+    
+    Static: type["StaticButton"]
     Link: type["LinkButton"]
     WebApp: type["WebAppButton"]
     Suggest: type["SuggestButton"]
     CopyText: type["CopyTextButton"]
     Callback: type["CallbackButton"]
+    Answer: type["AnswerButton"]
     Alert: type["AlertButton"]
     Notification: type["NotificationButton"]
     Invoke: type["InvokeButton"]
@@ -115,7 +123,29 @@ class InlineButton:
                 return normalized
             raise ValueError(f"Unknown style: {style!r}. Must be one of {_BUTTON_STYLES_LIST}")
         raise TypeError(f"Style must be str, ButtonStyle, or None, got {type(style)}")
+    
+    def _normalize_custom_emoji_id(self, custom_emoji_id: int | str | None) -> str | None:
+        if not custom_emoji_id:
+            return None
+        
+        if not TelekitState.is_premium():
+            return None
 
+        return str(custom_emoji_id)
+    
+class StaticButton(InlineButton):
+
+    def __init__(self, *, style: str | None | ButtonStyle = None, **kwargs):
+        self._style = self._normalize_style(style)
+        self._kwargs = kwargs
+        
+    def _compile(self, caption: str) -> InlineKeyboardButton:
+        return InlineKeyboardButton(
+            text=caption,
+            callback_data=CallbackQueryHandler.STATIC_BUTTON,
+            style=self._style,
+            **self._kwargs,
+        )
     
 class LinkButton(InlineButton):
     """
@@ -339,8 +369,8 @@ class CallbackButton(InlineButton):
 
         def __call__(self, call: CallbackQuery):
             self._invoke_chain_callback()
-            self._invoke_callback()
             self._answer_callback_query(call)
+            self._invoke_callback()
 
     def __init__(
             self,
@@ -387,7 +417,77 @@ class CallbackButton(InlineButton):
             callback=callback,
         )
     
-class AlertButton(CallbackButton):
+class AnswerButton(CallbackButton):
+
+    class _CallbackInvoker(CallbackButton._CallbackInvoker):
+        def __init__(
+                self, 
+                chain_callback: Callable[[], None],
+
+                answer_text: str | None = None,
+                answer_as_alert: bool = True,
+
+                persistent: bool = True,
+
+                style: str | None | ButtonStyle = None,
+
+                kwargs: dict[str, Any] = {}
+            ):
+            self._answer_text = answer_text
+            self._answer_as_alert = answer_as_alert
+
+            self._persistent = persistent
+
+            self._style = style
+
+            self._kwargs = {"style": style} | kwargs
+            
+            self._chain_callback: Callable[[], None] = chain_callback
+
+        def _answer_callback_query(self, call: CallbackQuery):
+            if self._answer_text:
+                InlineButton._bot.answer_callback_query(
+                    call.id,
+                    self._answer_text,
+                    self._answer_as_alert
+                )
+
+        def __call__(self, call: CallbackQuery):
+            if not self._persistent:
+                self._invoke_chain_callback()
+            self._answer_callback_query(call)
+
+    def __init__(
+            self,
+            answer_text: str | None = None,
+            answer_as_alert: bool = True,
+
+            persistent: bool = True,
+
+            style: str | None | ButtonStyle = None,
+
+            **kwargs
+        ):
+        self._answer_text = answer_text
+        self._answer_as_alert = answer_as_alert
+
+        self._persistent = persistent
+
+        self._style = self._normalize_style(style)
+
+        self._kwargs = kwargs
+        
+    def build_invoker(self, chain_callback: Callable[[], None]) -> _CallbackInvoker:
+        return self._CallbackInvoker(
+            chain_callback=chain_callback,
+            answer_text=self._answer_text,
+            answer_as_alert=self._answer_as_alert,
+            persistent=self._persistent,
+            style=self._style,
+            kwargs=self._kwargs
+        )
+
+class AlertButton(AnswerButton):
     """
     An inline keyboard button that shows a popup alert when pressed and terminates the chain.
 
@@ -424,19 +524,19 @@ class AlertButton(CallbackButton):
     def __init__(
             self,
             text: str | None = None,
-            *,
+            persistent: bool = True,
             style: str | None | ButtonStyle = None,
             **kwargs
         ):
         super().__init__(
-            callback=None,
             answer_text=text,
             answer_as_alert=True,
+            persistent=persistent,
             style=style,
             **kwargs
         )
 
-class NotificationButton(CallbackButton):
+class NotificationButton(AnswerButton):
     """
     An inline keyboard button that shows a brief notification at the top of the chat screen
     when pressed and terminates the chain.
@@ -475,13 +575,14 @@ class NotificationButton(CallbackButton):
             self,
             text: str | None = None,
             *,
+            persistent: bool = True,
             style: str | None | ButtonStyle = None,
             **kwargs
         ):
         super().__init__(
-            callback=None,
             answer_text=text,
             answer_as_alert=False,
+            persistent=persistent,
             style=style,
             **kwargs
         )
@@ -611,10 +712,12 @@ class InvokeButton(CallbackButton):
         )
     
 InlineButton.Link = LinkButton
+InlineButton.Static = StaticButton
 InlineButton.WebApp = WebAppButton
 InlineButton.Suggest = SuggestButton
 InlineButton.CopyText = CopyTextButton
 InlineButton.Callback = CallbackButton
+InlineButton.Answer = AnswerButton
 InlineButton.Alert = AlertButton
 InlineButton.Notification = NotificationButton
 InlineButton.Invoke = InvokeButton