@foxford/den 1.0.2 → 2.0.0

package/types-Deyolj1-.d.cts

@@ -0,0 +1,802 @@
+import { Token, Container, TokensToTypes } from '@foxford/ioc';
+
+/**
+ * Интерфейс для объектов с жизненным циклом страницы.
+ * Реализуется сервисами и ViewModel, чтобы Core мог управлять их lifecycle.
+ */
+interface Activatable {
+    /**
+     * Вызывается при активации страницы (SSR и клиент).
+     * @param params - Параметры маршрута (например, { id: '42' })
+     */
+    activate(params: Record<string, string>): void | Promise<void>;
+    /**
+     * Вызывается только на клиенте после hydration (опционально).
+     * @param params - Параметры маршрута
+     */
+    activateClient?(params: Record<string, string>): void | Promise<void>;
+    /**
+     * Вызывается при уходе со страницы (опционально).
+     */
+    deactivate?(): void | Promise<void>;
+}
+
+/**
+ * Базовый интерфейс для всех define*-определений.
+ * Содержит токен IoC и метод регистрации в контейнере.
+ * @template T - Тип регистрируемой зависимости
+ */
+interface Definition<T> {
+    /** Токен IoC для регистрации зависимости */
+    readonly token: Token<T>;
+    /**
+     * Регистрирует определение в IoC-контейнере.
+     * @param container - Контейнер для регистрации
+     */
+    register(container: Container): void;
+}
+/**
+ * ServiceDefinition — результат вызова defineService.
+ * Описывает сервис с lifecycle-хуками activate/deactivate.
+ * @template T - Тип сервиса
+ * @template Deps - Кортеж токенов зависимостей
+ */
+interface ServiceDefinition<T, Deps extends readonly Token<unknown>[]> extends Definition<T> {
+    /** Дискриминатор типа */
+    readonly __type: 'service';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей, используемых сервисом */
+        readonly requires: Deps;
+        /**
+         * Скоуп жизненного цикла сервиса.
+         * - `'app'` — синглтон на время жизни приложения (по умолчанию)
+         * - `'request'` — на сервере создаётся per HTTP-request, на клиенте — app-scope
+         */
+        readonly scope: 'app' | 'request';
+    };
+}
+/**
+ * ViewModelDefinition — результат вызова defineViewModel.
+ * Proxy для прямого импорта VM из view-компонентов.
+ * Поддерживает deferred resolution — контейнер не нужен на момент import.
+ * @template T - Тип ViewModel
+ * @template Deps - Кортеж токенов зависимостей
+ */
+interface ViewModelDefinition<T, Deps extends readonly Token<unknown>[]> extends Definition<T> {
+    /** Дискриминатор типа */
+    readonly __type: 'view-model';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей, используемых VM */
+        readonly requires: Deps;
+    };
+    /**
+     * Резолвит VM из глобального IoC-контейнера.
+     * Deferred resolution — вызывайте когда контейнер уже инициализирован.
+     * Используется в view-компонентах вместо явного вызова container.resolve.
+     * @returns Экземпляр VM или Promise с экземпляром
+     */
+    resolve(): T | Promise<T>;
+    /**
+     * Псевдоним для resolve(). Резолвит VM из глобального IoC-контейнера.
+     * @returns Экземпляр VM или Promise с экземпляром
+     */
+    use(): T | Promise<T>;
+}
+/**
+ * GuardDefinition — результат вызова defineGuard.
+ * Совместим с Guard interface и guardRunner.runGuards().
+ */
+interface GuardDefinition extends Definition<Guard> {
+    /** Дискриминатор типа */
+    readonly __type: 'guard';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей guard (пустой массив для инлайн-определений) */
+        readonly requires: readonly Token<unknown>[];
+    };
+}
+/** Опции для defineService */
+interface DefineServiceOptions<Deps extends readonly Token<unknown>[], T = unknown> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Скоуп жизненного цикла сервиса.
+     * - `'app'` — синглтон на время жизни приложения (по умолчанию)
+     * - `'request'` — на сервере создаётся per HTTP-request, на клиенте — app-scope
+     */
+    readonly scope?: 'app' | 'request';
+    /**
+     * Фабрика для создания экземпляра сервиса.
+     * Когда передана — регистрирует возвращаемый объект напрямую (без Activatable-обёртки).
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @returns Экземпляр сервиса
+     */
+    create?: (deps: TokensToTypes<Deps>) => T;
+    /**
+     * Вызывается при активации страницы.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @param params - Параметры маршрута
+     */
+    activate?: (deps: TokensToTypes<Deps>, params: Record<string, string>) => void | Promise<void>;
+    /**
+     * Вызывается при деактивации страницы (опционально).
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     */
+    deactivate?: (deps: TokensToTypes<Deps>) => void | Promise<void>;
+    /**
+     * Возвращает сериализуемое состояние сервиса для SSR-передачи на клиент (опционально).
+     * Наличие serialize/deserialize включает участие сервиса в StateRegistry контейнера.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @returns Plain-объект/значение, сериализуемое в JSON
+     */
+    serialize?: (deps: TokensToTypes<Deps>) => unknown;
+    /**
+     * Восстанавливает состояние сервиса из данных, сериализованных на сервере (опционально).
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @param data - Данные, полученные из serialize при SSR
+     */
+    deserialize?: (deps: TokensToTypes<Deps>, data: unknown) => void;
+}
+/** Опции для defineViewModel */
+interface DefineViewModelOptions<Deps extends readonly Token<unknown>[], T> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Фабрика для создания экземпляра VM.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @param cachedState - Закэшированный стейт из toJSON() при предыдущем визите (undefined при первом)
+     * @returns Экземпляр ViewModel
+     */
+    create: (deps: TokensToTypes<Deps>, cachedState?: unknown) => T;
+}
+/** Опции для defineGuard */
+interface DefineGuardOptions<Deps extends readonly Token<unknown>[] = readonly []> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Фабрика для создания экземпляра Guard с инъекцией зависимостей.
+     * Когда передана вместе с requires — создаёт Guard через конструктор с инъектированными зависимостями.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @returns Экземпляр Guard
+     */
+    create?: (deps: TokensToTypes<Deps>) => Guard;
+    /**
+     * Инлайн-реализация проверки доступа (используется когда create не передана).
+     * @param params - Параметры маршрута
+     * @returns Результат проверки или Promise с результатом
+     */
+    check?: (params: Record<string, string>) => GuardResult | Promise<GuardResult>;
+}
+/**
+ * Конфигурация приложения, регистрируемая в IoC-контейнере.
+ */
+interface HostConfig {
+    /** Сервисы, инициализируемые немедленно при старте */
+    readonly eager: readonly Token<unknown>[];
+    /** Сервисы, инициализируемые лениво (по требованию) */
+    readonly lazy: readonly Token<unknown>[];
+    /** Глобальные guards, применяемые ко всем страницам */
+    readonly guards: readonly Token<Guard>[];
+}
+/**
+ * HostDefinition — результат вызова defineHost.
+ * Декларирует конфигурацию приложения: eager/lazy сервисы, глобальные guards.
+ */
+interface HostDefinition extends Definition<HostConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'host';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Приложение не имеет requires-зависимостей */
+        readonly requires: readonly [];
+        /** Eager-сервисы */
+        readonly eager: readonly Token<unknown>[];
+        /** Lazy-сервисы */
+        readonly lazy: readonly Token<unknown>[];
+        /** Глобальные guards */
+        readonly guards: readonly Token<Guard>[];
+    };
+}
+/**
+ * RepositoryDefinition — результат вызова defineRepository.
+ * Описывает репозиторий уровня данных с IoC-биндингом.
+ * @template T - Тип репозитория
+ * @template Deps - Кортеж токенов зависимостей
+ */
+interface RepositoryDefinition<T, Deps extends readonly Token<unknown>[]> extends Definition<T> {
+    /** Дискриминатор типа */
+    readonly __type: 'repository';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей, используемых репозиторием */
+        readonly requires: Deps;
+        /**
+         * Скоуп жизненного цикла репозитория.
+         * - `'app'` — синглтон на время жизни приложения (по умолчанию)
+         * - `'request'` — на сервере создаётся per HTTP-request, на клиенте — app-scope
+         */
+        readonly scope: 'app' | 'request';
+    };
+}
+/** Опции для defineHost */
+interface DefineHostOptions {
+    /** Сервисы, инициализируемые немедленно при старте приложения */
+    readonly eager?: readonly Token<unknown>[];
+    /** Сервисы, инициализируемые лениво (по требованию) */
+    readonly lazy?: readonly Token<unknown>[];
+    /** Глобальные guards, применяемые ко всем страницам */
+    readonly guards?: readonly Token<Guard>[];
+}
+/**
+ * Опции для defineRepository
+ * @template Deps - Кортеж токенов зависимостей
+ * @template T - Тип репозитория
+ */
+interface DefineRepositoryOptions<Deps extends readonly Token<unknown>[], T> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Скоуп жизненного цикла репозитория.
+     * - `'app'` — синглтон на время жизни приложения (по умолчанию)
+     * - `'request'` — на сервере создаётся per HTTP-request, на клиенте — app-scope
+     */
+    readonly scope?: 'app' | 'request';
+    /**
+     * Фабрика для создания экземпляра репозитория.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @returns Экземпляр репозитория
+     */
+    create: (deps: TokensToTypes<Deps>) => T;
+}
+/**
+ * ActionGuard — перехватчик вызова метода Service.
+ * Позволяет вставить проверку (2FA, подтверждение) перед выполнением операции.
+ */
+interface ActionGuard {
+    /**
+     * Перехватывает вызов операции.
+     * @param next - Функция продолжения (оборачиваемая операция)
+     * @returns Промис с результатом операции
+     */
+    intercept<T>(next: () => Promise<T>): Promise<T>;
+}
+/**
+ * ActionGuardDefinition — результат вызова defineActionGuard.
+ * Регистрирует перехватчик вызовов метода Service в IoC.
+ * @template Deps - Кортеж токенов зависимостей
+ */
+interface ActionGuardDefinition<Deps extends readonly Token<unknown>[]> extends Definition<ActionGuard> {
+    /** Дискриминатор типа */
+    readonly __type: 'action-guard';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей перехватчика */
+        readonly requires: Deps;
+    };
+}
+/** Опции для defineActionGuard */
+interface DefineActionGuardOptions<Deps extends readonly Token<unknown>[]> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Реализация перехвата: получает зависимости и функцию продолжения.
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     * @param next - Оборачиваемая операция
+     * @returns Промис с результатом операции
+     */
+    intercept: (deps: TokensToTypes<Deps>, next: () => Promise<unknown>) => Promise<unknown>;
+}
+/**
+ * Конфигурация расширения (Extension), регистрируемая в IoC-контейнере.
+ * Extension — app-scope модуль с lifecycle (модалки, онбординг, очереди).
+ */
+interface ExtensionConfig {
+    /** Сигнатура поля для различения от других конфигов */
+    readonly __extensionConfig: true;
+}
+/**
+ * ExtensionDefinition — результат вызова defineExtension.
+ * Регистрирует app-scope Activatable с lifecycle в IoC.
+ * @template Deps - Кортеж токенов зависимостей
+ */
+interface ExtensionDefinition<Deps extends readonly Token<unknown>[]> extends Definition<ExtensionConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'extension';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Токены зависимостей расширения */
+        readonly requires: Deps;
+    };
+}
+/** Опции для defineExtension */
+interface DefineExtensionOptions<Deps extends readonly Token<unknown>[]> {
+    /** Список токенов зависимостей (опционально) */
+    readonly requires?: Deps;
+    /**
+     * Вызывается при активации расширения (загрузка приложения).
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     */
+    activate?: (deps: TokensToTypes<Deps>) => void | Promise<void>;
+    /**
+     * Вызывается при деактивации расширения (выгрузка приложения).
+     * @param deps - Разрешённые зависимости в порядке, соответствующем requires
+     */
+    deactivate?: (deps: TokensToTypes<Deps>) => void | Promise<void>;
+}
+/**
+ * Конфигурация layout, регистрируемая в IoC-контейнере.
+ */
+interface LayoutConfig {
+    /** Токены ViewModel, привязанных к layout */
+    readonly viewModels: readonly Token<unknown>[];
+    /** Именованные слоты layout: имя → токен */
+    readonly slots: Record<string, Token<unknown>>;
+}
+/**
+ * LayoutDefinition — результат вызова defineLayout.
+ * Декларирует layout с lifecycle и привязкой ViewModel.
+ */
+interface LayoutDefinition extends Definition<LayoutConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'layout';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Layout не имеет requires-зависимостей */
+        readonly requires: readonly [];
+        /** Токены ViewModel */
+        readonly viewModels: readonly Token<unknown>[];
+        /** Слоты layout */
+        readonly slots: Record<string, Token<unknown>>;
+    };
+}
+/** Опции для defineLayout */
+interface DefineLayoutOptions {
+    /** Токены ViewModel, привязанных к layout */
+    readonly viewModels?: readonly Token<unknown>[];
+    /** Именованные слоты layout: имя → токен */
+    readonly slots?: Record<string, Token<unknown>>;
+}
+/**
+ * Конфигурация конфигурационного слоя (Layer).
+ * Описывает view-адаптер для смены фреймворка рендеринга.
+ */
+interface LayerConfig {
+    /** Имя слоя (например, 'view') */
+    readonly name: string;
+    /** Адаптер view-фреймворка (react, vue и т.д.) */
+    readonly adapter: unknown;
+}
+/**
+ * LayerDefinition — результат вызова defineLayer.
+ * Описывает конфигурационный слой для view-фреймворка.
+ *
+ * Единственный конструктор — `defineLayer`. Руками этот тип не собирают, поэтому добавление
+ * обязательных полей сюда потребителей не ломает, а инварианты (например «config всегда есть»)
+ * держит фабрика, а не соглашение на месте использования.
+ */
+interface LayerDefinition extends Definition<LayerConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'layer';
+    /**
+     * Конфиг слоя — доступен и без контейнера.
+     *
+     * Нужен потому, что адаптер спрашивают в двух разных положениях: изнутри острова, где
+     * контейнер уже есть (резолв по токену), и снаружи, когда по дескриптору только собираются
+     * СОЗДАТЬ остров и контейнера ещё нет. Второму пути читать нечего, кроме самого дескриптора.
+     */
+    readonly config: LayerConfig;
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Layer не имеет requires-зависимостей */
+        readonly requires: readonly [];
+        /** Имя слоя */
+        readonly name: string;
+    };
+}
+/** Опции для defineLayer */
+interface DefineLayerOptions {
+    /** Имя слоя (например, 'view') */
+    readonly name: string;
+    /** Адаптер view-фреймворка */
+    readonly adapter: unknown;
+}
+
+/**
+ * Запись слота в реестре: имя + непрозрачная ссылка на view.
+ *
+ * `view` намеренно `unknown` — ядро не знает, что это компонент React/Vue/…: рендерит
+ * его view-адаптер. Так слот host-агностичен.
+ */
+interface SlotEntry {
+    /** Имя слота — по нему оркестратор решает, чем его заполнить. */
+    name: string;
+    /** Непрозрачная ссылка на view слота (компонент view-фреймворка). */
+    view: unknown;
+    /**
+     * View-слой ЭТОГО слота, если приложение переопределило его при `defineSlot`.
+     * Пусто — слот рисуется адаптером острова, в который попал.
+     */
+    viewLayer?: LayerDefinition;
+}
+/**
+ * Per-container реестр слотов.
+ *
+ * `defineSlot(...).register(container)` кладёт слот сюда; оркестратор (например
+ * федерация core-app) резолвит реестр из контейнера и перечисляет все зарегистрированные
+ * слоты — без сканирования исходников, чистый DI. Живёт столько же, сколько контейнер.
+ */
+declare class SlotRegistry {
+    /** Слоты по имени. Повторная регистрация с тем же именем перезаписывает. */
+    private readonly slots;
+    /**
+     * Регистрирует слот.
+     * @param entry - Запись слота (имя + непрозрачный view)
+     */
+    add(entry: SlotEntry): void;
+    /**
+     * Возвращает слот по имени.
+     * @param name - Имя слота
+     */
+    get(name: string): SlotEntry | undefined;
+    /**
+     * Возвращает все зарегистрированные слоты.
+     */
+    all(): readonly SlotEntry[];
+}
+
+/**
+ * Кэш сериализованных стейтов страниц.
+ * Используется для восстановления состояния при возврате на ранее посещённую страницу.
+ * Реализует LRU-стратегию с ограничением по количеству записей.
+ */
+declare class StateCache {
+    private cache;
+    private readonly maxSize;
+    /**
+     * @param maxSize - Максимальное количество кэшированных страниц (по умолчанию 10)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Сохраняет сериализованный стейт страницы.
+     * @param routeId - Идентификатор маршрута
+     * @param state - Сериализованный стейт (результат toJSON() от VM)
+     */
+    set(routeId: string, state: Record<string, unknown>): void;
+    /**
+     * Возвращает закэшированный стейт страницы или undefined.
+     * @param routeId - Идентификатор маршрута
+     */
+    get(routeId: string): Record<string, unknown> | undefined;
+    /**
+     * Удаляет кэш для страницы.
+     * @param routeId - Идентификатор маршрута
+     */
+    delete(routeId: string): void;
+    /** Очищает весь кэш. */
+    clear(): void;
+}
+
+/**
+ * Участник сериализации состояния — сервис, объявивший serialize/deserialize.
+ * Методы замкнуты на разрешённые зависимости сервиса и на его экземпляр,
+ * поэтому сериализатору не нужно повторно резолвить токены.
+ */
+interface StateParticipant {
+    /** Возвращает сериализуемое состояние (если сервис объявил serialize). */
+    toJSON?(): unknown;
+    /** Восстанавливает состояние из данных (если сервис объявил deserialize). */
+    fromJSON?(data: unknown): void;
+    /** Активирует сервис при входе на страницу (lifecycle-хук activate). */
+    activate?(params: Record<string, string>): void | Promise<void>;
+}
+/**
+ * Реестр участников сериализации в рамках одного контейнера.
+ *
+ * Живёт ровно столько, сколько контейнер (page/request), в который он забинжен
+ * контейнер-менеджером. Уничтожается вместе с контейнером через dispose — поэтому
+ * ссылки на страничные сервисы не утекают в app-scope, в отличие от прежнего
+ * app-scope Map в StateSerializerImpl.
+ */
+declare class StateRegistry {
+    /** Участники: стабильный ключ (token.description) → участник. */
+    private readonly participants;
+    /**
+     * Регистрирует участника сериализации.
+     * Повторная регистрация с тем же ключом перезаписывает предыдущего.
+     * @param key - Стабильный ключ (обычно token.description)
+     * @param participant - Участник с хуками toJSON/fromJSON/activate
+     */
+    add(key: string, participant: StateParticipant): void;
+    /**
+     * Возвращает всех зарегистрированных участников (ключ → участник).
+     */
+    all(): ReadonlyMap<string, StateParticipant>;
+}
+
+/**
+ * Контекст HTTP-запроса — заголовки и cookies, переданные сервером.
+ * На клиенте содержит пустые объекты.
+ */
+interface RequestContext {
+    /** HTTP-заголовки запроса (в нижнем регистре) */
+    headers: Record<string, string>;
+    /** Распарсенные cookies из заголовка Cookie */
+    cookies: Record<string, string>;
+}
+/**
+ * Результат проверки guard.
+ * - `{ allowed: true }` — переход разрешён
+ * - `{ allowed: false, redirect: string }` — переход запрещён, перенаправить по redirect
+ */
+type GuardResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    redirect: string;
+};
+/**
+ * Guard — функция проверки доступа к странице.
+ * Вызывается до активации страницы.
+ */
+interface Guard {
+    /**
+     * Проверяет доступ к маршруту.
+     * @param params - Параметры маршрута
+     * @returns Результат проверки
+     */
+    check(params: Record<string, string>): GuardResult | Promise<GuardResult>;
+}
+/**
+ * Запись в истории навигации.
+ */
+interface NavigationEntry {
+    /** Маршрут, с которого произошёл переход */
+    from: string | null;
+    /** Маршрут, на который произошёл переход */
+    to: string;
+    /** Параметры маршрута назначения */
+    params: Record<string, string>;
+    /** Временная метка перехода (ms) */
+    timestamp: number;
+}
+/**
+ * Менеджер дочерних контейнеров для страниц и запросов.
+ */
+interface ContainerManager {
+    /**
+     * Возвращает app-контейнер (синглтон).
+     */
+    getAppContainer(): Container;
+    /**
+     * Возвращает существующий дочерний контейнер страницы или undefined.
+     * @param routeId - Идентификатор маршрута
+     */
+    getPageContainer(routeId: string): Container | undefined;
+    /**
+     * Создаёт дочерний контейнер для страницы.
+     * Если контейнер для данного routeId уже существует, возвращает его.
+     * @param routeId - Идентификатор маршрута
+     */
+    createPageContainer(routeId: string): Container;
+    /**
+     * Уничтожает дочерний контейнер страницы и освобождает ресурсы.
+     * @param routeId - Идентификатор маршрута
+     */
+    destroyPageContainer(routeId: string): Promise<void>;
+    /**
+     * Создаёт дочерний контейнер для HTTP-запроса с забинженным RequestContext.
+     * Если контейнер для данного requestId уже существует, возвращает существующий.
+     * @param requestId - Уникальный идентификатор запроса
+     * @param context - Контекст запроса (заголовки и cookies)
+     */
+    createRequestContainer(requestId: string, context: RequestContext): Container;
+    /**
+     * Возвращает существующий контейнер запроса или undefined.
+     * @param requestId - Уникальный идентификатор запроса
+     */
+    getRequestContainer(requestId: string): Container | undefined;
+    /**
+     * Уничтожает контейнер запроса и освобождает ресурсы.
+     * Если контейнер не найден — no-op.
+     * @param requestId - Уникальный идентификатор запроса
+     */
+    destroyRequestContainer(requestId: string): Promise<void>;
+    /**
+     * Создаёт page container для SSR как дочерний от заданного родителя (обычно request container).
+     * Отслеживается менеджером — может быть уничтожен через destroySsrPageContainer после рендера.
+     * Если контейнер для данного requestId уже существует, возвращает существующий.
+     * @param requestId - Уникальный идентификатор запроса
+     * @param parent - Родительский контейнер
+     */
+    createSsrPageContainer(requestId: string, parent: Container): Container;
+    /**
+     * Уничтожает SSR page container и освобождает ресурсы (Disposable VM, сервисы).
+     * Вызывается в onAfterRenderHtml после завершения SSR-рендера.
+     * Если контейнер не найден — no-op.
+     * @param requestId - Уникальный идентификатор запроса
+     */
+    destroySsrPageContainer(requestId: string): Promise<void>;
+}
+/**
+ * Запускатель guards для страниц.
+ */
+interface GuardRunner {
+    /**
+     * Параллельно выполняет все guards и возвращает их результаты.
+     * Если передан container — guards резолвятся из него (request-scope).
+     * Без container — guards резолвятся из app-контейнера (поведение по умолчанию).
+     * @param tokens - Токены guards
+     * @param params - Параметры маршрута
+     * @param container - Опциональный контейнер для резолвинга guards (например, request container)
+     */
+    runGuards(tokens: Token<Guard>[], params: Record<string, string>, container?: Container): Promise<GuardResult[]>;
+}
+/**
+ * Объект, поддерживающий освобождение ресурсов.
+ * Возвращается методами регистрации для отмены подписки.
+ */
+interface Disposable {
+    /** Освобождает ресурсы и отменяет регистрацию. */
+    dispose(): void;
+}
+/**
+ * Перехватчик навигации — вызывается перед каждым переходом (leave guard).
+ */
+interface NavigationInterceptor {
+    /**
+     * Проверяет, разрешён ли переход.
+     * @param from - Текущий маршрут (откуда), null при первом переходе
+     * @param to - Целевой маршрут (куда)
+     * @returns Объект с результатом проверки
+     */
+    beforeNavigate(from: string | null, to: string): Promise<{
+        allow: boolean;
+        reason?: string;
+    }>;
+}
+/**
+ * Результат проверки leave guards.
+ * - `{ allow: true }` — переход разрешён
+ * - `{ allow: false, reason? }` — переход заблокирован
+ */
+type LeaveGuardResult = {
+    allow: true;
+} | {
+    allow: false;
+    reason?: string;
+};
+/**
+ * Менеджер навигации — хранит историю переходов и оповещает подписчиков.
+ */
+interface NavigationManager {
+    /** История переходов (не изменяется снаружи) */
+    readonly history: NavigationEntry[];
+    /** Текущая запись навигации */
+    current: NavigationEntry | null;
+    /**
+     * Подписывается на событие навигации.
+     * @param handler - Обработчик события
+     * @returns Функция отписки
+     */
+    onNavigate(handler: (entry: NavigationEntry) => void): () => void;
+    /**
+     * Записывает переход и оповещает подписчиков.
+     * @param from - Маршрут отправления
+     * @param to - Маршрут назначения
+     * @param params - Параметры маршрута
+     */
+    recordNavigation(from: string | null, to: string, params: Record<string, string>): void;
+    /**
+     * Проверяет актуальность текущего состояния (stub: всегда true).
+     */
+    checkFreshness(): Promise<boolean>;
+    /**
+     * Инициализирует обработчики браузерных событий навигации (только на клиенте).
+     */
+    initClientListeners(): void;
+    /**
+     * Регистрирует interceptor для перехвата навигации (leave guard).
+     * @param handler - Перехватчик навигации
+     * @returns Disposable для отмены регистрации
+     */
+    intercept(handler: NavigationInterceptor): Disposable;
+    /**
+     * Запускает все зарегистрированные leave guards последовательно.
+     * При первом заблокированном — возвращает `{ allow: false, reason? }`.
+     * @param from - Маршрут отправления
+     * @param to - Маршрут назначения
+     * @returns Результат проверки
+     */
+    runLeaveGuards(from: string | null, to: string): Promise<LeaveGuardResult>;
+}
+/**
+ * Сериализатор состояния для SSR.
+ * Протокол: plain objects.
+ *
+ * Не хранит состояние сам — работает поверх StateRegistry конкретного контейнера
+ * (page/request). Участники сериализации регистрируются в реестр контейнера через
+ * defineService({ serialize, deserialize }) при создании экземпляра сервиса, поэтому
+ * их время жизни ограничено контейнером и утечки в app-scope не происходит.
+ */
+interface StateSerializer {
+    /**
+     * Сериализует состояние участников из StateRegistry контейнера в plain object.
+     * Ключ записи — token.description сервиса.
+     * @param container - Контейнер, из реестра которого извлекаются данные
+     */
+    serialize(container: Container): Record<string, unknown>;
+    /**
+     * Восстанавливает состояние участников из plain object в контейнер.
+     * Вызывает deserialize только у тех участников, чей ключ есть в state.
+     * @param container - Целевой контейнер
+     * @param state - Сериализованное состояние
+     */
+    hydrate(container: Container, state: Record<string, unknown>): void;
+    /**
+     * Вызывает activate(params) на всех участниках реестра контейнера параллельно.
+     * Используется в Vike-хуках для активации страничных сервисов при входе на страницу.
+     * @param container - Контейнер, участники которого активируются
+     * @param params - Параметры маршрута (например, { id: '42' })
+     */
+    activateAll(container: Container, params: Record<string, string>): Promise<void>;
+}
+/**
+ * Основной объект Core Runtime.
+ * Создаётся фабрикой createCore и предоставляет доступ ко всем менеджерам.
+ */
+interface Core {
+    /** App-контейнер (IoC) */
+    container: Container;
+    /** Менеджер контейнеров страниц */
+    containerManager: ContainerManager;
+    /** Запускатель guards */
+    guardRunner: GuardRunner;
+    /** Менеджер навигации */
+    navigationManager: NavigationManager;
+    /** Кэш стейтов страниц для state persistence при back-навигации */
+    stateCache: StateCache;
+    /** Сериализатор состояния */
+    stateSerializer: StateSerializer;
+}
+/**
+ * Токен для регистрации ContainerManager в IoC-контейнере.
+ */
+declare const ContainerManagerToken: Token<ContainerManager>;
+/**
+ * Токен для регистрации GuardRunner в IoC-контейнере.
+ */
+declare const GuardRunnerToken: Token<GuardRunner>;
+/**
+ * Токен для регистрации NavigationManager в IoC-контейнере.
+ */
+declare const NavigationManagerToken: Token<NavigationManager>;
+/**
+ * Токен для регистрации StateSerializer в IoC-контейнере.
+ */
+declare const StateSerializerToken: Token<StateSerializer>;
+/**
+ * Токен per-container реестра участников сериализации.
+ * Свежий StateRegistry биндится контейнер-менеджером в каждый page/request-контейнер
+ * и уничтожается вместе с ним.
+ */
+declare const StateRegistryToken: Token<StateRegistry>;
+/**
+ * Токен per-container реестра слотов.
+ * `defineSlot(...).register(container)` кладёт слот сюда (get-or-create), оркестратор
+ * резолвит реестр и перечисляет зарегистрированные слоты.
+ */
+declare const SlotRegistryToken: Token<SlotRegistry>;
+/**
+ * Токен для регистрации Activatable-объектов в контейнере.
+ */
+declare const ActivatableToken: Token<Activatable>;
+/**
+ * Токен для доступа к RequestContext из IoC-контейнера.
+ * На сервере содержит headers/cookies текущего HTTP-запроса.
+ * На клиенте — пустые объекты.
+ */
+declare const RequestContextToken: Token<RequestContext>;
+
+export { type ActionGuard as A, GuardRunnerToken as B, type Core as C, type Disposable as D, type ExtensionConfig as E, NavigationManagerToken as F, type GuardRunner as G, type HostConfig as H, type RepositoryDefinition as I, RequestContextToken as J, type ServiceDefinition as K, type LeaveGuardResult as L, type SlotEntry as M, type NavigationManager as N, SlotRegistry as O, SlotRegistryToken as P, StateCache as Q, type RequestContext as R, type StateSerializer as S, type StateParticipant as T, StateRegistry as U, StateRegistryToken as V, StateSerializerToken as W, type ViewModelDefinition as X, type ContainerManager as a, type Guard as b, type GuardResult as c, type NavigationEntry as d, type NavigationInterceptor as e, type DefineGuardOptions as f, type GuardDefinition as g, type DefineHostOptions as h, type HostDefinition as i, type DefineExtensionOptions as j, type ExtensionDefinition as k, type DefineActionGuardOptions as l, type ActionGuardDefinition as m, type LayoutConfig as n, type DefineLayoutOptions as o, type LayoutDefinition as p, type LayerConfig as q, type DefineLayerOptions as r, type LayerDefinition as s, type Activatable as t, ActivatableToken as u, ContainerManagerToken as v, type DefineRepositoryOptions as w, type DefineServiceOptions as x, type DefineViewModelOptions as y, type Definition as z };