Update documentation and code snippets

docs/locales/en/LC_MESSAGES/root/api/app/autocompleter.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -30,14 +29,17 @@ msgid ""
 "подсказки и завершая ввод на основе истории команд, что ускоряет работу и"
 " снижает вероятность опечаток."
 msgstr ""
+"``AutoCompleter`` is a component responsible for interactive command autocompletion. "
+"It improves user experience by offering suggestions and completing input based on "
+"command history, which speeds up work and reduces the likelihood of typos."
 
 #: ../../root/api/app/autocompleter.rst:11
 msgid "Инициализация"
-msgstr ""
+msgstr "Initialization"
 
 #: ../../root/api/app/autocompleter.rst:18
 msgid "Создаёт и настраивает экземпляр ``AutoCompleter``."
-msgstr ""
+msgstr "Creates and configures an ``AutoCompleter`` instance."
 
 #: ../../root/api/app/autocompleter.rst:20
 msgid ""
@@ -45,20 +47,24 @@ msgid ""
 "указано, история будет сохраняться между сессиями. При значении ``None`` "
 "история хранится только в контексте сессии."
 msgstr ""
+"``history_filename``: Filename for saving command history. If specified, history "
+"will be saved between sessions. When set to ``None``, history is stored only within "
+"the session context."
 
 #: ../../root/api/app/autocompleter.rst:21
 msgid ""
 "``autocomplete_button``: Клавиша, активирующая автодополнение. По "
 "умолчанию — **Tab**."
 msgstr ""
+"``autocomplete_button``: Key that activates autocompletion. Defaults to **Tab**."
 
 #: ../../root/api/app/autocompleter.rst:26
 msgid "Назначение и возможности"
-msgstr ""
+msgstr "Purpose and Features"
 
 #: ../../root/api/app/autocompleter.rst:28
 msgid "Основные возможности ``AutoCompleter``:"
-msgstr ""
+msgstr "Main features of ``AutoCompleter``:"
 
 #: ../../root/api/app/autocompleter.rst:30
 msgid ""
@@ -66,6 +72,8 @@ msgid ""
 "умолчанию **Tab**) система ищет в истории команды, начинающиеся с уже "
 "введённого текста."
 msgstr ""
+"**History-based autocompletion**: When the autocompletion key is pressed (by default **Tab**), "
+"the system searches history for commands starting with the already entered text."
 
 #: ../../root/api/app/autocompleter.rst:32
 msgid ""
@@ -74,6 +82,9 @@ msgid ""
 "``show_profile`` при вводе ``sho`` и нажатии **Tab** ввод дополнится до "
 "``show_``."
 msgstr ""
+"**Common prefix**: If multiple commands with a common prefix are found, only the common "
+"part will be inserted. For example, for commands ``show_users`` and ``show_profile``, "
+"when entering ``sho`` and pressing **Tab**, the input will be completed to ``show_``."
 
 #: ../../root/api/app/autocompleter.rst:34
 msgid ""
@@ -81,24 +92,29 @@ msgid ""
 "сохраняется в файл при выходе и загружается при следующем запуске. Это "
 "делает автодополнение со временем «умнее»."
 msgstr ""
+"**Persistent history**: If ``history_filename`` is specified, command history is saved "
+"to a file on exit and loaded on the next startup. This makes autocompletion \"smarter\" over time."
 
 #: ../../root/api/app/autocompleter.rst:36
 msgid ""
 "**Очистка истории**: При сохранении ``AutoCompleter`` удаляет дубликаты и"
 " несуществующие команды, поддерживая историю в актуальном состоянии."
 msgstr ""
+"**History cleanup**: When saving, ``AutoCompleter`` removes duplicates and non-existent "
+"commands, keeping the history up to date."
 
 #: ../../root/api/app/autocompleter.rst:38
 msgid ""
 "**Настройка клавиши**: Клавишу автодополнения можно изменить с помощью "
 "параметра ``autocomplete_button``."
 msgstr ""
+"**Key customization**: The autocompletion key can be changed using the ``autocomplete_button`` parameter."
 
 #: ../../root/api/app/autocompleter.rst:43
 msgid "Пример использования"
-msgstr ""
+msgstr "Usage Example"
 
 #: ../../root/api/app/autocompleter.rst:45
 msgid "``AutoCompleter`` передаётся как аргумент при инициализации `App`."
-msgstr ""
+msgstr "``AutoCompleter`` is passed as an argument when initializing `App`."
 

docs/locales/en/LC_MESSAGES/root/api/app/dividing_lines.po

@@ -21,7 +21,7 @@ msgstr ""
 
 #: ../../root/api/app/dividing_lines.rst:4
 msgid "Dividing Lines"
-msgstr ""
+msgstr "Dividing Lines"
 
 #: ../../root/api/app/dividing_lines.rst:6
 msgid ""
@@ -29,10 +29,12 @@ msgid ""
 "структурирования вывода и отделения блоков информации друг от друга. "
 "Библиотека предлагает два типа линий: статическую и динамическую."
 msgstr ""
+"Dividing lines in ``Argenta`` are used for visual structuring of output and separating "
+"information blocks from each other. The library offers two types of lines: static and dynamic."
 
 #: ../../root/api/app/dividing_lines.rst:11
 msgid "``StaticDividingLine``"
-msgstr ""
+msgstr "``StaticDividingLine``"
 
 #: ../../root/api/app/dividing_lines.rst:13
 msgid ""
@@ -40,24 +42,28 @@ msgid ""
 "длины. Этот тип линии полезен для создания предсказуемого и "
 "унифицированного интерфейса."
 msgstr ""
+"``StaticDividingLine`` creates a dividing line of **fixed** length. This type of line "
+"is useful for creating a predictable and unified interface."
 
 #: ../../root/api/app/dividing_lines.rst:21
 msgid "Создаёт экземпляр статической разделительной линии."
-msgstr ""
+msgstr "Creates a static dividing line instance."
 
 #: ../../root/api/app/dividing_lines.rst:23
 msgid ""
 "``unit_part``: Символ для построения линии (учитывается только первый "
 "символ). По умолчанию: ``-``."
 msgstr ""
+"``unit_part``: Character for building the line (only the first character is considered). "
+"Defaults to: ``-``."
 
 #: ../../root/api/app/dividing_lines.rst:24
 msgid "``length``: Фиксированная длина линии. По умолчанию: ``25``."
-msgstr ""
+msgstr "``length``: Fixed line length. Defaults to: ``25``."
 
 #: ../../root/api/app/dividing_lines.rst:29
 msgid "``DynamicDividingLine``"
-msgstr ""
+msgstr "``DynamicDividingLine``"
 
 #: ../../root/api/app/dividing_lines.rst:31
 msgid ""
@@ -66,40 +72,45 @@ msgid ""
 "перехвата ``stdout``, в результате чего разделители идеально обрамляют "
 "выводимый контент."
 msgstr ""
+"``DynamicDividingLine`` creates a line whose length **dynamically** adjusts to the longest "
+"line in the command output. This requires capturing ``stdout``, resulting in dividers that "
+"perfectly frame the output content."
 
 #: ../../root/api/app/dividing_lines.rst:38
 msgid "Создаёт экземпляр динамической разделительной линии."
-msgstr ""
+msgstr "Creates a dynamic dividing line instance."
 
 #: ../../root/api/app/dividing_lines.rst:40
 msgid "``unit_part``: Символ для построения линии. По умолчанию: ``-``."
-msgstr ""
+msgstr "``unit_part``: Character for building the line. Defaults to: ``-``."
 
 #: ../../root/api/app/dividing_lines.rst:42
 msgid "Длина вычисляется автоматически и не задаётся при инициализации."
-msgstr ""
+msgstr "Length is calculated automatically and is not set during initialization."
 
 #: ../../root/api/app/dividing_lines.rst:45
 msgid ""
 "Обязательно почитайте про нюансы использования динамических линий и "
 "перехвата ``stdout`` в :ref:`этом разделе<root_redirect_stdout>`."
 msgstr ""
+"Be sure to read about the nuances of using dynamic lines and capturing ``stdout`` "
+"in :ref:`this section<root_redirect_stdout>`."
 
 #: ../../root/api/app/dividing_lines.rst:50
 msgid "Назначение и использование"
-msgstr ""
+msgstr "Purpose and Usage"
 
 #: ../../root/api/app/dividing_lines.rst:52
 msgid "Выбор между статической и динамической линией зависит от ваших задач."
-msgstr ""
+msgstr "The choice between static and dynamic lines depends on your needs."
 
 #: ../../root/api/app/dividing_lines.rst:54
 msgid "**StaticDividingLine** идеально подходит, если:"
-msgstr ""
+msgstr "**StaticDividingLine** is ideal if:"
 
 #: ../../root/api/app/dividing_lines.rst:56
 msgid "Вам нужен строгий и консистентный дизайн."
-msgstr ""
+msgstr "You need a strict and consistent design."
 
 #: ../../root/api/app/dividing_lines.rst:57
 msgid ""
@@ -107,30 +118,34 @@ msgid ""
 "(``disable_redirect_stdout=True``), где динамическое вычисление длины "
 "невозможно."
 msgstr ""
+"You are using routers with disabled ``stdout`` capture (``disable_redirect_stdout=True``), "
+"where dynamic length calculation is not possible."
 
 #: ../../root/api/app/dividing_lines.rst:59
 msgid ""
 "**DynamicDividingLine** (поведение по умолчанию) — предпочтительный "
 "выбор, если:"
-msgstr ""
+msgstr "**DynamicDividingLine** (default behavior) is the preferred choice if:"
 
 #: ../../root/api/app/dividing_lines.rst:61
 msgid "Вы хотите, чтобы интерфейс был адаптивным."
-msgstr ""
+msgstr "You want the interface to be adaptive."
 
 #: ../../root/api/app/dividing_lines.rst:62
 msgid "Вывод ваших команд имеет разную длину."
-msgstr ""
+msgstr "Your command output has varying lengths."
 
 #: ../../root/api/app/dividing_lines.rst:63
 msgid ""
 "В ваших обработчиках нет интерактивных операций ввода (например, "
 "``input()``)."
-msgstr ""
+msgstr "Your handlers do not have interactive input operations (e.g., ``input()``)."
 
 #: ../../root/api/app/dividing_lines.rst:65
 msgid ""
 "Тип разделителя для всего приложения задаётся при инициализации ``App`` "
 "через параметр ``dividing_line``."
 msgstr ""
+"The divider type for the entire application is set during ``App`` initialization "
+"via the ``dividing_line`` parameter."
 

docs/locales/en/LC_MESSAGES/root/api/app/index.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -30,180 +29,199 @@ msgid ""
 "взаимодействие с пользователем, координируя работу всех компонентов: "
 "роутеров, обработчиков и системных сообщений."
 msgstr ""
+"The ``App`` object is the core of your console application. It handles "
+"configuration, lifecycle management, command processing, and user interaction, "
+"coordinating the work of all components: routers, handlers, and system messages."
 
 #: ../../root/api/app/index.rst:11
 msgid "Инициализация"
-msgstr ""
+msgstr "Initialization"
 
 #: ../../root/api/app/index.rst:38
 msgid "Создаёт и настраивает экземпляр приложения."
-msgstr ""
+msgstr "Creates and configures an application instance."
 
 #: ../../root/api/app/index.rst:40
 msgid "``prompt``: Приглашение к вводу, отображаемое перед каждой командой."
-msgstr ""
+msgstr "``prompt``: Input prompt displayed before each command."
 
 #: ../../root/api/app/index.rst:41
 msgid "``initial_message``: Сообщение, выводимое при запуске приложения."
-msgstr ""
+msgstr "``initial_message``: Message displayed when the application starts."
 
 #: ../../root/api/app/index.rst:42
 msgid "``farewell_message``: Сообщение, выводимое при выходе из приложения."
-msgstr ""
+msgstr "``farewell_message``: Message displayed when exiting the application."
 
 #: ../../root/api/app/index.rst:43
 msgid ""
 "``exit_command``: Команда, которая маркируется как триггер для выхода из "
 "приложения."
 msgstr ""
+"``exit_command``: Command that is marked as a trigger for exiting the application."
 
 #: ../../root/api/app/index.rst:44
 msgid ""
 "``system_router_title``: Заголовок для системного роутера (содержит "
 "команду выхода)."
 msgstr ""
+"``system_router_title``: Title for the system router (contains the exit command)."
 
 #: ../../root/api/app/index.rst:45
 msgid ""
 "``ignore_command_register``: Если ``True``, регистр вводимых команд "
 "игнорируется при поиске обработчика."
 msgstr ""
+"``ignore_command_register``: If ``True``, command case is ignored when searching for a handler."
 
 #: ../../root/api/app/index.rst:46
 msgid ""
 "``dividing_line``: Тип разделительной линии (``StaticDividingLine`` или "
 "``DynamicDividingLine``)."
 msgstr ""
+"``dividing_line``: Type of dividing line (``StaticDividingLine`` or ``DynamicDividingLine``)."
 
 #: ../../root/api/app/index.rst:47
 msgid ""
 "``repeat_command_groups_printing``: Если ``True``, список доступных "
 "команд выводится перед каждым вводом."
 msgstr ""
+"``repeat_command_groups_printing``: If ``True``, the list of available commands is displayed before each input."
 
 #: ../../root/api/app/index.rst:48
 msgid ""
 "``override_system_messages``: Если ``True``, стандартное форматирование "
 "(цвета, ASCII-арт) отключается."
 msgstr ""
+"``override_system_messages``: If ``True``, standard formatting (colors, ASCII art) is disabled."
 
 #: ../../root/api/app/index.rst:49
 msgid ""
 "``autocompleter``: Экземпляр класса :ref:`AutoCompleter "
 "<root_api_app_autocompleter>`, отвечающий за автодополнение команд."
 msgstr ""
+"``autocompleter``: Instance of the :ref:`AutoCompleter <root_api_app_autocompleter>` "
+"class responsible for command autocompletion."
 
 #: ../../root/api/app/index.rst:50
 msgid ""
 "``print_func``: Функция для вывода всех системных сообщений (по умолчанию"
 " ``rich.Console().print``)."
 msgstr ""
+"``print_func``: Function for outputting all system messages (defaults to ``rich.Console().print``)."
 
 #: ../../root/api/app/index.rst:55
 msgid "Основные методы"
-msgstr ""
+msgstr "Main Methods"
 
 #: ../../root/api/app/index.rst:59
 msgid ""
 "Регистрирует роутер в приложении. Все команды из этого роутера становятся"
 " доступными для вызова."
 msgstr ""
+"Registers a router in the application. All commands from this router become available for invocation."
 
 #: ../../root/api/app/index.rst
 msgid "Parameters"
-msgstr ""
+msgstr "Parameters"
 
 #: ../../root/api/app/index.rst:61
 msgid "Экземпляр ``Router`` для регистрации."
-msgstr ""
+msgstr "``Router`` instance to register."
 
 #: ../../root/api/app/index.rst:65
 msgid "Регистрирует несколько роутеров одновременно."
-msgstr ""
+msgstr "Registers multiple routers simultaneously."
 
 #: ../../root/api/app/index.rst:67
 msgid "Последовательность экземпляров ``Router`` для регистрации."
-msgstr ""
+msgstr "Sequence of ``Router`` instances to register."
 
 #: ../../root/api/app/index.rst:71
 msgid ""
 "Добавляет текстовое сообщение, которое выводится при запуске приложения "
 "после ``initial_message``."
 msgstr ""
+"Adds a text message that is displayed when the application starts after ``initial_message``."
 
 #: ../../root/api/app/index.rst:73
 msgid "Строка с сообщением."
-msgstr ""
+msgstr "String with the message."
 
 #: ../../root/api/app/index.rst:76
 msgid ""
 "Для вывода стандартных сообщений можно использовать готовые шаблоны из "
 ":ref:`PredefinedMessages <root_api_predefined_messages>`."
 msgstr ""
+"For outputting standard messages, you can use ready-made templates from "
+":ref:`PredefinedMessages <root_api_predefined_messages>`."
 
 #: ../../root/api/app/index.rst:81
 msgid "Методы установки обработчиков"
-msgstr ""
+msgstr "Handler Setup Methods"
 
 #: ../../root/api/app/index.rst:83
 msgid ""
 "``App`` позволяет настраивать реакцию на различные события, такие как "
 "ошибки ввода или неизвестные команды."
 msgstr ""
+"``App`` allows you to configure responses to various events, such as input errors or unknown commands."
 
 #: ../../root/api/app/index.rst:86
 msgid ""
 "Подробнее о исключениях и их обработке в соответствующем :ref:`разделе "
 "документации <root_error_handling>`."
 msgstr ""
+"For more details on exceptions and their handling, see the corresponding "
+":ref:`documentation section <root_error_handling>`."
 
 #: ../../root/api/app/index.rst:92
 msgid "Устанавливает шаблон для форматирования описания команды."
-msgstr ""
+msgstr "Sets the template for formatting command descriptions."
 
 #: ../../root/api/app/index.rst:94
 msgid "Обработчик принимает триггер команды (``str``) и её описание (``str``)."
-msgstr ""
+msgstr "The handler accepts the command trigger (``str``) and its description (``str``)."
 
 #: ../../root/api/app/index.rst:100
 msgid "Устанавливает обработчик при некорректном введённом синтаксисе флагов."
-msgstr ""
+msgstr "Sets the handler for incorrect flag syntax input."
 
 #: ../../root/api/app/index.rst:102 ../../root/api/app/index.rst:110
 msgid "Обработчик принимает строку, введённую пользователем."
-msgstr ""
+msgstr "The handler accepts the string entered by the user."
 
 #: ../../root/api/app/index.rst:108
 msgid "Устанавливает обработчик при повторяющихся флагах в введённой команде."
-msgstr ""
+msgstr "Sets the handler for duplicate flags in the entered command."
 
 #: ../../root/api/app/index.rst:116
 msgid "Устанавливает обработчик при вводе неизвестной команды."
-msgstr ""
+msgstr "Sets the handler for entering an unknown command."
 
 #: ../../root/api/app/index.rst:118
 msgid "Обработчик принимает объект ``InputCommand`` - объект введённой команды."
-msgstr ""
+msgstr "The handler accepts an ``InputCommand`` object - the entered command object."
 
 #: ../../root/api/app/index.rst:124
 msgid "Устанавливает обработчик при вводе пустой строки."
-msgstr ""
+msgstr "Sets the handler for entering an empty string."
 
 #: ../../root/api/app/index.rst:126
 msgid "Обработчик не принимает аргументов."
-msgstr ""
+msgstr "The handler accepts no arguments."
 
 #: ../../root/api/app/index.rst:132
 msgid "Переопределяет стандартное поведение при вызове команды выхода."
-msgstr ""
+msgstr "Overrides the default behavior when the exit command is invoked."
 
 #: ../../root/api/app/index.rst:134
 msgid "Обработчик принимает объект ``Response``."
-msgstr ""
+msgstr "The handler accepts a ``Response`` object."
 
 #: ../../root/api/app/index.rst:147
 msgid "PredefinedMessages"
-msgstr ""
+msgstr "PredefinedMessages"
 
 #: ../../root/api/app/index.rst:149
 msgid ""
@@ -212,32 +230,35 @@ msgid ""
 "``rich`` и предназначены для вывода стандартной информации, такой как "
 "подсказки по использованию."
 msgstr ""
+"``PredefinedMessages`` is a container containing a set of ready-to-use messages. "
+"They are formatted using ``rich`` syntax and are intended for displaying standard "
+"information, such as usage hints."
 
 #: ../../root/api/app/index.rst:151
 msgid "Реккомендуется использовать их при старте приложения."
-msgstr ""
+msgstr "It is recommended to use them when starting the application."
 
 #: ../../root/api/app/index.rst:178
 msgid "Строка: ``[b dim]Usage[/b dim]: [i]<command> <[green]flags[/green]>[/i]``"
-msgstr ""
+msgstr "String: ``[b dim]Usage[/b dim]: [i]<command> <[green]flags[/green]>[/i]``"
 
 #: ../../root/api/app/index.rst:180
 msgid "Отображается как: ``Usage: <command> <flags>``"
-msgstr ""
+msgstr "Displayed as: ``Usage: <command> <flags>``"
 
 #: ../../root/api/app/index.rst:184
 msgid "Строка: ``[b dim]Help[/b dim]: [i]<command>[/i] [b red]--help[/b red]``"
-msgstr ""
+msgstr "String: ``[b dim]Help[/b dim]: [i]<command>[/i] [b red]--help[/b red]``"
 
 #: ../../root/api/app/index.rst:186
 msgid "Отображается как: ``Help: <command> --help``"
-msgstr ""
+msgstr "Displayed as: ``Help: <command> --help``"
 
 #: ../../root/api/app/index.rst:190
 msgid "Строка: ``[b dim]Autocomplete[/b dim]: [i]<part>[/i] [bold]<tab>``"
-msgstr ""
+msgstr "String: ``[b dim]Autocomplete[/b dim]: [i]<part>[/i] [bold]<tab>``"
 
 #: ../../root/api/app/index.rst:192
 msgid "Отображается как: ``Autocomplete: <part> <tab>``"
-msgstr ""
+msgstr "Displayed as: ``Autocomplete: <part> <tab>``"
 

docs/locales/en/LC_MESSAGES/root/api/bridge.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
 
 #: ../../root/api/bridge.rst:4
 msgid "DataBridge"
-msgstr ""
+msgstr "DataBridge"
 
 #: ../../root/api/bridge.rst:6
 msgid ""
@@ -29,66 +28,75 @@ msgid ""
 "данных, которое существует в рамках одной сессии приложения (от запуска "
 "до выхода). Она предназначена для обмена данными между обработчиками."
 msgstr ""
+"``DataBridge`` is an entity that provides temporary data storage that exists within "
+"a single application session (from startup to exit). It is designed for data "
+"exchange between handlers."
 
 #: ../../root/api/bridge.rst:8
 msgid "Основной способ получения доступа к ``DataBridge`` — через ``di``."
-msgstr ""
+msgstr "The main way to access ``DataBridge`` is through ``di``."
 
 #: ../../root/api/bridge.rst:21
 msgid "**Практический пример: Аутентификация**"
-msgstr ""
+msgstr "**Practical Example: Authentication**"
 
 #: ../../root/api/bridge.rst:23
 msgid ""
 "Рассмотрим пример, где команда `login` сохраняет токен аутентификации, а "
 "команда `get-profile` использует его."
 msgstr ""
+"Let's consider an example where the `login` command saves an authentication token, "
+"and the `get-profile` command uses it."
 
 #: ../../root/api/bridge.rst:29
 msgid "**Как это работает:**"
-msgstr ""
+msgstr "**How it works:**"
 
 #: ../../root/api/bridge.rst:31
 msgid ""
 "При вызове обработчика ``dishka`` автоматически внедряет экземпляр "
 "``DataBridge``."
-msgstr ""
+msgstr "When calling a handler, ``dishka`` automatically injects a ``DataBridge`` instance."
 
 #: ../../root/api/bridge.rst:32
 msgid ""
 "Команда ``login --username <имя>`` вызывает ``login_handler``, который "
 "через внедрённый ``data_bridge`` сохраняет токен."
 msgstr ""
+"The ``login --username <name>`` command calls ``login_handler``, which saves the "
+"token through the injected ``data_bridge``."
 
 #: ../../root/api/bridge.rst:33
 msgid ""
 "Команда ``get-profile`` вызывает ``get_profile_handler``, который так же "
 "получает ``data_bridge`` и извлекает из него токен."
 msgstr ""
+"The ``get-profile`` command calls ``get_profile_handler``, which also receives "
+"``data_bridge`` and extracts the token from it."
 
 #: ../../root/api/bridge.rst:42
 msgid ""
 "Инициализирует хранилище. При использовании через ``di`` вызывается "
 "автоматически."
-msgstr ""
+msgstr "Initializes the storage. When used through ``di``, it is called automatically."
 
 #: ../../root/api/bridge.rst:46
 msgid "Обновляет хранилище данными из словаря."
-msgstr ""
+msgstr "Updates the storage with data from a dictionary."
 
 #: ../../root/api/bridge.rst:50
 msgid "Возвращает все данные из хранилища."
-msgstr ""
+msgstr "Returns all data from the storage."
 
 #: ../../root/api/bridge.rst:54
 msgid "Возвращает значение по ключу или ``None``, если ключ не найден."
-msgstr ""
+msgstr "Returns the value by key or ``None`` if the key is not found."
 
 #: ../../root/api/bridge.rst:58
 msgid "Удаляет значение по ключу. Вызывает ``KeyError``, если ключ не найден."
-msgstr ""
+msgstr "Deletes the value by key. Raises ``KeyError`` if the key is not found."
 
 #: ../../root/api/bridge.rst:62
 msgid "Полностью очищает хранилище."
-msgstr ""
+msgstr "Completely clears the storage."
 

docs/locales/en/LC_MESSAGES/root/api/index.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -21,31 +20,31 @@ msgstr ""
 
 #: ../../root/api/index.rst:5
 msgid "Публичное API"
-msgstr ""
+msgstr "Public API"
 
 #: ../../root/api/index.rst:8
 msgid "Описание раздела"
-msgstr ""
+msgstr "Section Description"
 
 #: ../../root/api/index.rst:10
 msgid "В этом разделе описан публичный API библиотеки. Он включает:"
-msgstr ""
+msgstr "This section describes the library's public API. It includes:"
 
 #: ../../root/api/index.rst:12
 msgid "Классы и функции для интеграции в ваши приложения."
-msgstr ""
+msgstr "Classes and functions for integration into your applications."
 
 #: ../../root/api/index.rst:13
 msgid "Рекомендации по использованию и поддерживаемые сценарии."
-msgstr ""
+msgstr "Usage recommendations and supported scenarios."
 
 #: ../../root/api/index.rst:14
 msgid "Примеры кода, подробные сигнатуры и описание возвращаемых значений."
-msgstr ""
+msgstr "Code examples, detailed signatures, and descriptions of return values."
 
 #: ../../root/api/index.rst:15
 msgid "Гарантии стабильности и обратной совместимости."
-msgstr ""
+msgstr "Stability and backward compatibility guarantees."
 
 #: ../../root/api/index.rst:17
 msgid ""
@@ -55,134 +54,164 @@ msgid ""
 "здесь. Это обеспечит стабильность и совместимость ваших продуктов с "
 "будущими версиями ``Argenta``."
 msgstr ""
+"Interfaces not described in this section are considered internal. Using them may "
+"lead to errors when updating the library. When developing your own solutions, use "
+"only the components described here. This will ensure the stability and compatibility "
+"of your products with future versions of ``Argenta``."
 
 #: ../../root/api/index.rst:22
 msgid "Публичные импорты"
-msgstr ""
+msgstr "Public Imports"
 
 #: ../../root/api/index.rst:24
 msgid ""
 "Все основные компоненты библиотеки доступны для прямого импорта из "
 "корневого пакета ``argenta`` или его подмодулей."
 msgstr ""
+"All main library components are available for direct import from the root package "
+"``argenta`` or its submodules."
 
 #: ../../root/api/index.rst:27
 msgid "Основные компоненты"
-msgstr ""
+msgstr "Main Components"
 
 #: ../../root/api/index.rst:32
 msgid ""
 ":ref:`App <root_api_app_index>` — Объект приложения, который отвечает за "
 "логику роутинга, настройки, валидации и т.д."
 msgstr ""
+":ref:`App <root_api_app_index>` — Application object responsible for routing logic, "
+"settings, validation, etc."
 
 #: ../../root/api/index.rst:33
 msgid ""
 ":ref:`Orchestrator <root_api_orchestrator_index>` — Класс для "
 "конфигурирования и запуска всего приложения."
 msgstr ""
+":ref:`Orchestrator <root_api_orchestrator_index>` — Class for configuring and "
+"launching the entire application."
 
 #: ../../root/api/index.rst:34
 msgid ""
 ":ref:`Router <root_api_router>` — Класс для группировки и регистрации "
 "команд."
-msgstr ""
+msgstr ":ref:`Router <root_api_router>` — Class for grouping and registering commands."
 
 #: ../../root/api/index.rst:35
 msgid ""
 ":ref:`Command <root_api_command_index>` — Класс для создания команд при "
 "инициализации хэндлеров."
 msgstr ""
+":ref:`Command <root_api_command_index>` — Class for creating commands when "
+"initializing handlers."
 
 #: ../../root/api/index.rst:36
 msgid ""
 ":ref:`Response <root_api_response>` — Объект ответа, передаваемый в "
 "обработчики."
-msgstr ""
+msgstr ":ref:`Response <root_api_response>` — Response object passed to handlers."
 
 #: ../../root/api/index.rst:39
 msgid "Команды и флаги"
-msgstr ""
+msgstr "Commands and Flags"
 
 #: ../../root/api/index.rst:52
 msgid ":ref:`Flag <root_api_command_flag>` — Класс для описания флага."
-msgstr ""
+msgstr ":ref:`Flag <root_api_command_flag>` — Class for describing a flag."
 
 #: ../../root/api/index.rst:53
 msgid ":ref:`Flags <root_api_command_flags>` — Коллекция для регистрации флагов."
-msgstr ""
+msgstr ":ref:`Flags <root_api_command_flags>` — Collection for registering flags."
 
 #: ../../root/api/index.rst:54
 msgid ""
 ":ref:`InputFlag <root_api_command_input_flag>` — Класс для введённого "
 "пользователем флага."
 msgstr ""
+":ref:`InputFlag <root_api_command_input_flag>` — Class for a user-entered flag."
 
 #: ../../root/api/index.rst:55
 msgid ""
 ":ref:`InputFlags <root_api_command_input_flags>` — Коллекция введённых "
 "флагов."
-msgstr ""
+msgstr ":ref:`InputFlags <root_api_command_input_flags>` — Collection of entered flags."
 
 #: ../../root/api/index.rst:56
 msgid ""
 ":ref:`PossibleValues <root_api_command_possible_values>` — Правила "
 "валидации значений флага."
 msgstr ""
+":ref:`PossibleValues <root_api_command_possible_values>` — Validation rules for "
+"flag values."
 
 #: ../../root/api/index.rst:57
 msgid ""
 ":ref:`ValidationStatus <root_api_command_validation_status>` — Статусы "
 "валидации флагов."
 msgstr ""
+":ref:`ValidationStatus <root_api_command_validation_status>` — Flag validation statuses."
 
 #: ../../root/api/index.rst:58
 msgid ""
 ":ref:`PredefinedFlags <root_api_command_flag_predefined_flags>` — "
 "Коллекция предопределённых флагов."
 msgstr ""
+":ref:`PredefinedFlags <root_api_command_flag_predefined_flags>` — Collection of "
+"predefined flags."
 
 #: ../../root/api/index.rst:61
 msgid "Настройка приложения"
-msgstr ""
+msgstr "Application Configuration"
 
 #: ../../root/api/index.rst:71
 msgid ""
 ":ref:`AutoCompleter <root_api_app_autocompleter>` - Класс для настройки "
 "автодополнения."
 msgstr ""
+":ref:`AutoCompleter <root_api_app_autocompleter>` - Class for configuring "
+"autocompletion."
 
 #: ../../root/api/index.rst:72
 msgid ""
 ":ref:`StaticDividingLine <root_api_app_dividing_lines>` — Статическая "
 "разделительная линия для оформления вывода."
 msgstr ""
+":ref:`StaticDividingLine <root_api_app_dividing_lines>` — Static dividing line for "
+"output formatting."
 
+#: ../../root/api/index.rst:73
 #: ../../root/api/index.rst:73
 msgid ""
 ":ref:`DynamicDividingLine <root_api_app_dividing_lines>` — Динамическая "
 "разделительная линия для оформления вывода."
 msgstr ""
-
+":ref:`DynamicDividingLine <root_api_app_dividing_lines>` — Dynamic dividing line "
+"for output formatting."
 #: ../../root/api/index.rst:74
 msgid ""
 ":ref:`PredefinedMessages <root_api_predefined_messages>` — Готовые "
 "сообщения для вывода при старте приложения."
 msgstr ""
+":ref:`PredefinedMessages <root_api_predefined_messages>` — Ready-made messages for "
+"output at application startup."
 
 #: ../../root/api/index.rst:77
 msgid "Внедрение зависимостей"
-msgstr ""
+msgstr "Dependency Injection"
 
 #: ../../root/api/index.rst:85
 msgid ""
 ":ref:`FromDishka <root_dependency_injection>` — Маркер аргумента функции "
 "как зависимости, которая должна быть инжектирована."
 msgstr ""
+":ref:`FromDishka <root_dependency_injection>` — Marker for a function argument as a "
+"dependency that should be injected."
 
 #: ../../root/api/index.rst:86
 msgid ""
 ":ref:`inject <root_dependency_injection>` — Декоратор для инжектирования "
 "зависимостей, указанных в сигнатуре."
 msgstr ""
+":ref:`inject <root_dependency_injection>` — Decorator for injecting dependencies "
+"specified in the signature."
 

docs/locales/en/LC_MESSAGES/root/api/response.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
 
 #: ../../root/api/response.rst:4
 msgid "Response"
-msgstr ""
+msgstr "Response"
 
 #: ../../root/api/response.rst:6
 msgid ""
@@ -29,44 +28,52 @@ msgid ""
 "создаётся автоматически при обработке пользовательского ввода и содержит "
 "статус валидации, введённые флаги."
 msgstr ""
+"``Response`` is an object that is passed to the command handler. It is created "
+"automatically when processing user input and contains validation status and entered flags."
 
 #: ../../root/api/response.rst:11
 msgid ""
 "Документация по :ref:`InputFlags <root_api_command_input_flags>` — "
 "коллекция введённых флагов команды."
 msgstr ""
+"Documentation for :ref:`InputFlags <root_api_command_input_flags>` — collection of "
+"entered command flags."
 
 #: ../../root/api/response.rst:13
 msgid ""
 "Документация по :ref:`ResponseStatus <root_api_response_status>` — "
 "статусы валидации флагов команды."
 msgstr ""
+"Documentation for :ref:`ResponseStatus <root_api_response_status>` — command flag "
+"validation statuses."
 
 #: ../../root/api/response.rst:15
 msgid ""
 "Документация по :ref:`InputFlag <root_api_command_input_flag>` — "
 "отдельный введённый флаг."
 msgstr ""
+"Documentation for :ref:`InputFlag <root_api_command_input_flag>` — individual "
+"entered flag."
 
 #: ../../root/api/response.rst:20
 msgid "Инициализация"
-msgstr ""
+msgstr "Initialization"
 
 #: ../../root/api/response.rst:30
 msgid "Создаёт новый объект ответа."
-msgstr ""
+msgstr "Creates a new response object."
 
 #: ../../root/api/response.rst:32
 msgid ""
 "``status``: Общий статус валидации флагов из перечисления "
 "``ResponseStatus``."
-msgstr ""
+msgstr "``status``: Overall flag validation status from the ``ResponseStatus`` enumeration."
 
 #: ../../root/api/response.rst:33
 msgid ""
 "``input_flags``: Коллекция введённых флагов (``InputFlags``). По "
 "умолчанию — пустая."
-msgstr ""
+msgstr "``input_flags``: Collection of entered flags (``InputFlags``). Empty by default."
 
 #: ../../root/api/response.rst:36
 msgid ""
@@ -74,10 +81,12 @@ msgid ""
 "автоматически формируются системой и передаются в обработчик команды в "
 "качестве первого обязательного аргумента."
 msgstr ""
+"Instances of this class are not intended for direct creation. They are automatically "
+"formed by the system and passed to the command handler as the first required argument."
 
 #: ../../root/api/response.rst:38
 msgid "**Атрибуты:**"
-msgstr ""
+msgstr "**Attributes:**"
 
 #: ../../root/api/response.rst:43
 msgid ""
@@ -85,20 +94,24 @@ msgid ""
 "Указывает, были ли среди введённых флагов некорректные или "
 "незарегистрированные."
 msgstr ""
+"Overall validation status of all command flags (``ResponseStatus``). Indicates "
+"whether there were any incorrect or unregistered flags among the entered ones."
 
 #: ../../root/api/response.rst:48
 msgid ""
 "Коллекция всех флагов, переданных с командой (``InputFlags``). Содержит "
 "все обработанные флаги с их значениями и статусами валидации."
 msgstr ""
+"Collection of all flags passed with the command (``InputFlags``). Contains all "
+"processed flags with their values and validation statuses."
 
 #: ../../root/api/response.rst:50
 msgid "**Пример использования:**"
-msgstr ""
+msgstr "**Usage example:**"
 
 #: ../../root/api/response.rst:59
 msgid "Работа с флагами"
-msgstr ""
+msgstr "Working with Flags"
 
 #: ../../root/api/response.rst:61
 msgid ""
@@ -106,14 +119,16 @@ msgid ""
 "``input_flags``. Вы можете проверять их наличие, получать значения и "
 "статусы валидации."
 msgstr ""
+"``Response`` provides access to entered flags through the ``input_flags`` attribute. "
+"You can check their presence, get values, and validation statuses."
 
 #: ../../root/api/response.rst:63
 msgid "**Пример работы с флагами:**"
-msgstr ""
+msgstr "**Example of working with flags:**"
 
 #: ../../root/api/response.rst:74
 msgid "ResponseStatus"
-msgstr ""
+msgstr "ResponseStatus"
 
 #: ../../root/api/response.rst:76
 msgid ""
@@ -121,6 +136,8 @@ msgid ""
 "валидации всех флагов команды. Используется в атрибуте ``status`` объекта"
 " ``Response``."
 msgstr ""
+"``ResponseStatus`` is an enumeration that defines the overall validation status of "
+"all command flags. Used in the ``status`` attribute of the ``Response`` object."
 
 #: ../../root/api/response.rst:79
 msgid "ALL_FLAGS_VALID"
@@ -131,6 +148,7 @@ msgid ""
 "Все введённые флаги прошли валидацию. Нет ни некорректных, ни "
 "незарегистрированных флагов."
 msgstr ""
+"All entered flags passed validation. There are no incorrect or unregistered flags."
 
 #: ../../root/api/response.rst:89
 msgid "UNDEFINED_FLAGS"
@@ -141,6 +159,7 @@ msgid ""
 "Среди введённых флагов есть незарегистрированные, но нет флагов с "
 "некорректными значениями."
 msgstr ""
+"Among the entered flags, there are unregistered ones, but no flags with incorrect values."
 
 #: ../../root/api/response.rst:99
 msgid "INVALID_VALUE_FLAGS"
@@ -151,6 +170,7 @@ msgid ""
 "Среди введённых флагов есть флаги с некорректными значениями, но нет "
 "незарегистрированных."
 msgstr ""
+"Among the entered flags, there are flags with incorrect values, but no unregistered ones."
 
 #: ../../root/api/response.rst:109
 msgid "UNDEFINED_AND_INVALID_FLAGS"
@@ -161,4 +181,5 @@ msgid ""
 "Среди введённых флагов есть как незарегистрированные, так и флаги с "
 "некорректными значениями."
 msgstr ""
+"Among the entered flags, there are both unregistered flags and flags with incorrect values."
 

docs/locales/en/LC_MESSAGES/root/api/router.po

@@ -3,7 +3,6 @@
 # This file is distributed under the same license as the Argenta package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Argenta \n"
@@ -30,6 +29,9 @@ msgid ""
 " Каждый роутер представляет собой логический контейнер для определённого "
 "набора функций."
 msgstr ""
+"``Router`` is the main building block for organizing logic in an "
+"application. Its purpose is to group related commands and their handlers. "
+"Each router represents a logical container for a specific set of functions."
 
 #: ../../root/api/router.rst:8
 msgid ""
@@ -37,20 +39,25 @@ msgid ""
 "отвечать за аутентификацию (``login``, ``logout``), а другой — за "
 "операции с профилем (``profile-show``, ``profile-edit``)."
 msgstr ""
+"For example, in a user management application, one router can handle "
+"authentication (``login``, ``logout``), while another handles profile "
+"operations (``profile-show``, ``profile-edit``)."
 
 #: ../../root/api/router.rst:13
 msgid "Инициализация"
-msgstr ""
+msgstr "Initialization"
 
 #: ../../root/api/router.rst:21
 msgid "Создаёт новый экземпляр роутера."
-msgstr ""
+msgstr "Creates a new router instance."
 
 #: ../../root/api/router.rst:23
 msgid ""
 "``title``: Необязательный заголовок для группы команд. Отображается в "
 "списке доступных команд, помогая пользователю ориентироваться."
 msgstr ""
+"``title``: Optional title for the command group. Displayed in the list of "
+"available commands to help users navigate."
 
 #: ../../root/api/router.rst:24
 msgid ""
@@ -60,24 +67,30 @@ msgid ""
 "используется статическая разделительная линия. Подробнее см. в разделе "
 ":ref:`Переопределение стандартного вывода <root_redirect_stdout>`."
 msgstr ""
+"``disable_redirect_stdout``: If ``True``, disables ``stdout`` capture for "
+"all commands in this router. This is necessary for interactive commands "
+"(e.g., with ``input()``). When capture is disabled, a static separator line "
+"is automatically used. See :ref:`Overriding standard output <root_redirect_stdout>` "
+"for more details."
 
 #: ../../root/api/router.rst:29
 msgid "Регистрация команд"
-msgstr ""
+msgstr "Command Registration"
 
 #: ../../root/api/router.rst:31
 msgid ""
 "Для регистрации команды и привязки к ней обработчика используется "
 "декоратор ``@command``."
 msgstr ""
+"The ``@command`` decorator is used to register a command and bind a handler to it."
 
 #: ../../root/api/router.rst:35
 msgid "Декоратор для регистрации функции как обработчика команды."
-msgstr ""
+msgstr "Decorator for registering a function as a command handler."
 
 #: ../../root/api/router.rst
 msgid "Parameters"
-msgstr ""
+msgstr "Parameters"
 
 #: ../../root/api/router.rst:37
 msgid ""
@@ -85,20 +98,25 @@ msgid ""
 "Может быть строкой, которая станет триггером (без возможности настройки "
 "флагов и описания)."
 msgstr ""
+"A ``Command`` instance describing the trigger, flags, and command description. "
+"Can be a string that will become the trigger (without the ability to configure "
+"flags and description)."
 
 #: ../../root/api/router.rst:39
 msgid "**Пример использования:**"
-msgstr ""
+msgstr "**Usage example:**"
 
 #: ../../root/api/router.rst:48
 msgid "Системный роутер"
-msgstr ""
+msgstr "System Router"
 
 #: ../../root/api/router.rst:50
 msgid ""
 "``Argenta`` поставляется со встроенным системным роутером, который "
 "автоматически подключается к каждому приложению."
 msgstr ""
+"``Argenta`` comes with a built-in system router that is automatically "
+"connected to every application."
 
 #: ../../root/api/router.rst:55
 msgid ""
@@ -106,6 +124,9 @@ msgid ""
 " умолчанию — команда выхода). Имеет заголовок **«System points:»**, "
 "который можно переопределить в ``App``."
 msgstr ""
+"A predefined ``Router`` instance with basic system commands (by default, "
+"the exit command). Has the title **\"System points:\"**, which can be "
+"overridden in ``App``."
 
 #: ../../root/api/router.rst:57
 msgid ""
@@ -113,30 +134,35 @@ msgid ""
 "``argenta.router.defaults.system_router`` и используйте его декоратор "
 "``@command``."
 msgstr ""
+"You can add your own commands to this router. To do this, import "
+"``argenta.router.defaults.system_router`` and use its ``@command`` decorator."
 
 #: ../../root/api/router.rst:62
 msgid "Возможные исключения"
-msgstr ""
+msgstr "Possible Exceptions"
 
 #: ../../root/api/router.rst:64
 msgid ""
 "При регистрации команд и флагов в ``Router`` могут возникнуть следующие "
 "исключения:"
 msgstr ""
+"The following exceptions may occur when registering commands and flags in ``Router``:"
 
 #: ../../root/api/router.rst:68
 msgid ""
 "Выбрасывается, если триггер команды в ``Command`` содержит пробелы. "
 "Триггеры должны быть одним словом."
 msgstr ""
+"Raised if the command trigger in ``Command`` contains spaces. "
+"Triggers must be a single word."
 
 #: ../../root/api/router.rst:70
 msgid "**Неправильно:** ``Command(\"add user\")``"
-msgstr ""
+msgstr "**Incorrect:** ``Command(\"add user\")``"
 
 #: ../../root/api/router.rst:72
 msgid "**Правильно:** ``Command(\"add-user\")``"
-msgstr ""
+msgstr "**Correct:** ``Command(\"add-user\")``"
 
 #: ../../root/api/router.rst:76
 msgid ""
@@ -144,14 +170,17 @@ msgid ""
 "дублирующиеся имена. Имена флагов в рамках одной команды должны быть "
 "уникальны."
 msgstr ""
+"Raised if duplicate names were used when defining flags for a command. "
+"Flag names within a single command must be unique."
 
 #: ../../root/api/router.rst:78
 msgid "**Пример, вызывающий исключение:**"
-msgstr ""
+msgstr "**Example that raises an exception:**"
 
 #: ../../root/api/router.rst:90
 msgid ""
 "Возникает, если обработчик команды не принимает обязательный аргумент "
 "``Response``."
 msgstr ""
+"Raised if the command handler does not accept the required ``Response`` argument."