Выделены отдельные расширения

BotPages.Core/BotPagesApp.cs

@@ -4,6 +4,7 @@ using BotPages.Core.Abstractions;
 using BotPages.Core.Context;
 using BotPages.Core.Logging;
 using BotPages.Core.Routing;
+using System.Reflection;
 
 /// <summary>
 /// Основное приложение BotPages.
@@ -90,6 +91,45 @@ public sealed class BotPagesApp
         return this;
     }
 
+    /// <summary>
+    /// Зарегистрировать все маршруты для страницы.
+    /// Маршрутом является <see cref="RouteAttribute"/>.
+    /// Так же берется полное название класса.
+    /// </summary>
+    public BotPagesApp AutoMapRoute()
+    {
+        // Берём все загруженные сборки в текущем AppDomain
+        var assemblies = AppDomain.CurrentDomain.GetAssemblies();
+
+        // Находим все типы, которые наследуются от Page
+        var pageTypes = assemblies
+            .SelectMany(a =>
+            {
+                try
+                {
+                    return a.GetTypes();
+                }
+                catch (ReflectionTypeLoadException ex)
+                {
+                    // Если часть типов не загрузилась — берём только успешные
+                    return ex.Types.Where(t => t != null)!;
+                }
+            })
+            .Where(t => t != null
+                        && t.IsClass
+                        && !t.IsAbstract
+                        && t.IsSubclassOf(typeof(Page)))
+            .ToList();
+
+        // Выводим полные имена
+        foreach (var type in pageTypes)
+        {
+            _routes.Map(type);
+        }
+
+        return this;
+    }
+
     /// <summary>
     /// Обработать входящее обновление.
     /// </summary>
@@ -161,7 +201,7 @@ public sealed class BotPagesApp
 
         if (page is null)
         {
-            await ctx.Navigation.GoToHome(ctx, ct);
+            await ctx.Navigation.GoToHomeAsync(ctx, ct);
             return;
         }
 

BotPages.Core/Context/PageContext.cs

@@ -22,47 +22,6 @@ public sealed class PageContext
     /// <summary>Адаптер мессенджера.</summary>
     public required IMessengerAdapter Adapter { get; init; }
 
-    //Storage
-
-    /// <summary>Получить состояние по ключу.</summary>
-    public Task<T?> GetStorageAsync<T>(string key, CancellationToken ct)
-        => StateStorage.GetAsync<T>(SessionKey, key, ct);
-
-    /// <summary>Сохранить состояние по ключу.</summary>
-    public Task SetStorageAsync<T>(string key, T state, CancellationToken ct)
-        => StateStorage.SetAsync<T>(SessionKey, key, state, ct);
-
-    /// <summary>Удалить состояние по ключу.</summary>
-    public Task<bool> RemoveStorageAsync(string key, CancellationToken ct)
-        => StateStorage.RemoveAsync(SessionKey, key, ct);
-
-    /// <summary>Удалить все состояния по ключу.</summary>
-    public Task<bool> ClearStorageAsync(CancellationToken ct)
-        => StateStorage.ClearAsync(SessionKey, ct);
-
-    //Adapter
-
-    /// <summary>
-    /// Отправить текстовое сообщение.
-    /// </summary>
-    public Task SendTextAsync(string text, MessageFormat format = MessageFormat.Plain,
-        IEnumerable<IEnumerable<InlineButton>>? inline = null,
-        IEnumerable<IEnumerable<ReplyButton>>? reply = null,
-        CancellationToken ct = default)
-        => Adapter.SendTextAsync(this.Update.Chat.Id, text, format, inline, reply, ct);
-
-    /// <summary>
-    /// Отправить файл.
-    /// </summary>
-    public Task SendFileAsync(FileDescriptor file, string? caption = null, MessageFormat? captionFormat = null, CancellationToken ct = default)
-        => Adapter.SendFileAsync(this.Update.Chat.Id, file, caption, captionFormat, ct);
-
-    /// <summary>
-    /// Отправить файл.
-    /// </summary>
-    public Task SendFileAsync(FileDescriptor file, string? caption = null, CancellationToken ct = default)
-        => Adapter.SendFileAsync(this.Update.Chat.Id, file, caption, null, ct);
-
     /// <summary>
     /// Получить билдер альбомов.
     /// </summary>

BotPages.Core/Context/PageContextAdapterExtensions.cs

@@ -0,0 +1,31 @@
+using BotPages.Core.Abstractions;
+using BotPages.Core.Messaging;
+
+namespace BotPages.Core;
+
+/// <summary>
+/// Расширения <see cref="PageContext"/> для работы с <see cref="IMessengerAdapter"/>
+/// </summary>
+public static class PageContextAdapterExtensions
+{
+    /// <summary>
+    /// Отправить текстовое сообщение.
+    /// </summary>
+    public static Task SendTextAsync(this PageContext ctx, string text, MessageFormat format = MessageFormat.Plain,
+        IEnumerable<IEnumerable<InlineButton>>? inline = null,
+        IEnumerable<IEnumerable<ReplyButton>>? reply = null,
+        CancellationToken ct = default)
+        => ctx.Adapter.SendTextAsync(ctx.Update.Chat.Id, text, format, inline, reply, ct);
+
+    /// <summary>
+    /// Отправить файл.
+    /// </summary>
+    public static Task SendFileAsync(this PageContext ctx, FileDescriptor file, string? caption = null, MessageFormat? captionFormat = null, CancellationToken ct = default)
+        => ctx.Adapter.SendFileAsync(ctx.Update.Chat.Id, file, caption, captionFormat, ct);
+
+    /// <summary>
+    /// Отправить файл.
+    /// </summary>
+    public static Task SendFileAsync(this PageContext ctx, FileDescriptor file, string? caption = null, CancellationToken ct = default)
+        => ctx.Adapter.SendFileAsync(ctx.Update.Chat.Id, file, caption, null, ct);
+}

BotPages.Core/Context/PageContextNavigationExtensions.cs

@@ -0,0 +1,38 @@
+namespace BotPages.Core;
+
+/// <summary>
+/// Расширения <see cref="PageContext"/> для работы с <see cref="NavigationService"/>
+/// </summary>
+public static class PageContextNavigationExtensions
+{
+
+    /// <summary>
+    /// Перейти по маршруту без аргументов.
+    /// </summary>
+    public static Task GoToHomeAsync(this PageContext ctx, CancellationToken ct)
+        => ctx.Navigation.GoToHomeAsync(ctx, ct);
+
+    /// <summary>
+    /// Перейти по маршруту без аргументов.
+    /// </summary>
+    public static Task GoToAsync(this PageContext ctx, string route, CancellationToken ct)
+        => ctx.Navigation.GoToAsync(route, ctx, ct);
+
+    /// <summary>
+    /// Перейти по маршруту с аргументами.
+    /// </summary>
+    public static Task GoToAsync<TArgs>(this PageContext ctx, string route, TArgs args, CancellationToken ct)
+        => ctx.Navigation.GoToAsync<TArgs>(route, args, ctx, ct);
+
+    /// <summary>
+    /// Перейти на страницу без аргументов.
+    /// </summary>
+    public static Task GoToAsync<TPage>(this PageContext ctx, CancellationToken ct) where TPage : Page
+        => ctx.Navigation.GoToAsync<TPage>(ctx, ct);
+
+    /// <summary>
+    /// Перейти на страницу с аргументами.
+    /// </summary>
+    public static Task GoToAsync<TPage, TArgs>(this PageContext ctx, TArgs args, CancellationToken ct) where TPage : StatefullPage<TArgs>
+        => ctx.Navigation.GoToAsync<TPage, TArgs>(ctx, args!, ct);
+}

BotPages.Core/Context/PageContextStorageExtensions.cs

@@ -0,0 +1,26 @@
+using BotPages.Core.Abstractions;
+
+namespace BotPages.Core;
+
+/// <summary>
+/// Расширения <see cref="PageContext"/> для работы с <see cref="IStateStorage"/>
+/// </summary>
+public static class PageContextStorageExtensions
+{
+
+    /// <summary>Получить состояние по ключу.</summary>
+    public static Task<T?> GetStorageAsync<T>(this PageContext ctx, string key, CancellationToken ct)
+        => ctx.StateStorage.GetAsync<T>(ctx.SessionKey, key, ct);
+
+    /// <summary>Сохранить состояние по ключу.</summary>
+    public static Task SetStorageAsync<T>(this PageContext ctx, string key, T state, CancellationToken ct)
+        => ctx.StateStorage.SetAsync<T>(ctx.SessionKey, key, state, ct);
+
+    /// <summary>Удалить состояние по ключу.</summary>
+    public static Task<bool> RemoveStorageAsync(this PageContext ctx, string key, CancellationToken ct)
+        => ctx.StateStorage.RemoveAsync(ctx.SessionKey, key, ct);
+
+    /// <summary>Удалить все состояния по ключу.</summary>
+    public static Task<bool> ClearStorageAsync(this PageContext ctx, CancellationToken ct)
+        => ctx.StateStorage.ClearAsync(ctx.SessionKey, ct);
+}

BotPages.Core/Navigation/NavigationService.cs

@@ -31,7 +31,7 @@ public sealed class NavigationService
     /// <summary>
     /// Перейти по маршруту без аргументов.
     /// </summary>
-    public Task GoToHome(PageContext ctx, CancellationToken ct)
+    public Task GoToHomeAsync(PageContext ctx, CancellationToken ct)
     {
         return NavigateAsync(_defaultPage!, ctx, null, ct);
     }

BotPages.Core/Routing/RoutesRegistry.cs

@@ -1,4 +1,6 @@
-namespace BotPages.Core.Routing;
+using System.Reflection;
+
+namespace BotPages.Core.Routing;
 
 /// <summary>
 /// Реестр маршрутов страниц.
@@ -26,4 +28,14 @@ internal sealed class RoutesRegistry
     /// Получить снимок всех маршрутов.
     /// </summary>
     public IReadOnlyDictionary<string, Type> Snapshot() => _routes;
+
+    internal void Map(Type? type)
+    {
+        foreach(var attr in type.GetCustomAttributes<RouteAttribute>(inherit: true))
+        {
+            _routes.Add(attr.Template, type);
+        }
+
+        _routes.Add(type.FullName, type);
+    }
 }

Demo/Pages/SubmitPage.cs

@@ -27,7 +27,7 @@ public sealed class SubmitPage : SingletonPage
         }
         while (i < 100);
 
-        await ctx.Navigation.GoToHome(ctx, ct);
+        await ctx.Navigation.GoToHomeAsync(ctx, ct);
     }
 
     public override Task OnLeave(PageContext ctx, CancellationToken ct)

Demo/Pages/TitlePage.cs

@@ -19,7 +19,7 @@ public sealed class TitlePage : SingletonPage
     {
         if (text == "Меню")
         {
-            return ctx.Navigation.GoToHome(ctx, ct);
+            return ctx.Navigation.GoToHomeAsync(ctx, ct);
         }
         else
         {

TZ.md

@@ -17,7 +17,6 @@
 - **Page** — класс, отвечающий за состояние экрана бота.  
   - `Page` — базовый класс.  
   - `Page<TArguments>` — страница с аргументами.  
-  - `ModalPage` / `ModalPage<TArguments>` — модальная страница (перехватывает ввод, блокирует переходы).  
 - **Контекст:**  
   - `UserContext` — данные пользователя (UserId, MessengerType).  
   - `ChatContext` — данные чата (ChatId, Title, ThreadId?, ленивое обновление).  
@@ -25,7 +24,7 @@
 - **Состояние:**  
   - `IStateStorage` — универсальный интерфейс хранения.  
   - Базовая реализация: InMemory.  
-  - Ключ: `CompositeSessionKey(MessengerType:string, ChatId, UserId?)`.  
+  - Ключ: `CompositeSessionKey(MessengerType:string, ChatId, UserId)`.  
   - История состояний: опционально (None, LastN, TimeWindow, Full).  
 
 ---
@@ -125,7 +124,7 @@
   ```
 - Пример:
   ```csharp
-  app.AddMiddleware<IUpdateMiddleware, LoggingMiddleware>();
+  app.AddMiddleware<LoggingMiddleware>();
   app.AddMiddleware<ErrorMiddleware>(params);
   ```
 - Порядок регистрации = порядок выполнения.