@foxford/den 1.0.0

package/define-slot--HM6B232.d.ts

@@ -0,0 +1,500 @@
+import { Token, Container, TokensToTypes } from '@foxford/ioc';
+import { b as Guard, c as GuardResult } from './types-B4Arep3V.js';
+
+/**
+ * Базовый интерфейс для всех 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 AppConfig {
+    /** Сервисы, инициализируемые немедленно при старте */
+    readonly eager: readonly Token<unknown>[];
+    /** Сервисы, инициализируемые лениво (по требованию) */
+    readonly lazy: readonly Token<unknown>[];
+    /** Глобальные guards, применяемые ко всем страницам */
+    readonly guards: readonly Token<Guard>[];
+}
+/**
+ * AppDefinition — результат вызова defineApp.
+ * Декларирует конфигурацию приложения: eager/lazy сервисы, глобальные guards.
+ */
+interface AppDefinition extends Definition<AppConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'app';
+    /** Метаданные определения */
+    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';
+    };
+}
+/** Опции для defineApp */
+interface DefineAppOptions {
+    /** Сервисы, инициализируемые немедленно при старте приложения */
+    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-фреймворка.
+ */
+interface LayerDefinition extends Definition<LayerConfig> {
+    /** Дискриминатор типа */
+    readonly __type: 'layer';
+    /** Метаданные определения */
+    readonly __meta: {
+        /** Layer не имеет requires-зависимостей */
+        readonly requires: readonly [];
+        /** Имя слоя */
+        readonly name: string;
+    };
+}
+/** Опции для defineLayer */
+interface DefineLayerOptions {
+    /** Имя слоя (например, 'view') */
+    readonly name: string;
+    /** Адаптер view-фреймворка */
+    readonly adapter: unknown;
+}
+
+/**
+ * Определяет сервис с IoC-биндингом и опциональными lifecycle-хуками activate/deactivate.
+ * Если передана опция create — регистрирует экземпляр класса напрямую (как Singleton).
+ * Если create не передана — создаёт Activatable-обёртку с хуками activate/deactivate.
+ *
+ * @template T - Тип регистрируемого сервиса
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации сервиса в IoC
+ * @param options - Опции: requires, create, activate, deactivate
+ * @returns ServiceDefinition с методом register(container)
+ *
+ * @example
+ * // С фабрикой create (сервис-класс регистрируется напрямую)
+ * const authService = defineService(AuthServiceToken, {
+ *   create: () => new AuthService(),
+ * })
+ * authService.register(appContainer)
+ *
+ * @example
+ * // С lifecycle-хуками (без create)
+ * const dataService = defineService(DataServiceToken, {
+ *   requires: [RepoToken] as const,
+ *   activate: ([repo], params) => repo.loadData(params.id),
+ *   deactivate: ([repo]) => repo.cleanup(),
+ * })
+ * dataService.register(appContainer)
+ */
+declare function defineService<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineServiceOptions<Deps, T>): ServiceDefinition<T, Deps>;
+
+/**
+ * Определяет ViewModel с IoC-биндингом и proxy для прямого импорта из view.
+ * Поддерживает deferred resolution — контейнер не нужен на момент импорта модуля.
+ * Метод resolve() делегирует резолв стратегии активного host-адаптера
+ * (см. `@foxford/den/adapter` → `installResolver`).
+ *
+ * @template T - Тип ViewModel
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации VM в IoC
+ * @param options - Опции: requires, create
+ * @returns ViewModelDefinition с методами register(container) и resolve()
+ *
+ * @example
+ * // home.vm.ts — создаётся при импорте модуля
+ * export const homeVm = defineViewModel(HomeVmToken, {
+ *   requires: [UserServiceToken] as const,
+ *   create: ([userService]) => ({
+ *     title: userService.getTitle(),
+ *   }),
+ * })
+ *
+ * // home.view.tsx — контейнер уже инициализирован
+ * const vm = await homeVm.use()
+ */
+declare function defineViewModel<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineViewModelOptions<Deps, T>): ViewModelDefinition<T, Deps>;
+
+/**
+ * Определяет репозиторий уровня данных с IoC-биндингом.
+ * Регистрирует Singleton-фабрику в IoC-контейнере.
+ * В отличие от defineService, репозиторий не имеет activate/deactivate lifecycle —
+ * он предоставляет методы доступа к данным без управления состоянием страницы.
+ *
+ * @template T - Тип регистрируемого репозитория
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации репозитория в IoC
+ * @param options - Опции: requires, create
+ * @returns RepositoryDefinition с методом register(container)
+ *
+ * @example
+ * const userRepo = defineRepository(UserRepoToken, {
+ *   requires: [HttpServiceToken] as const,
+ *   create: ([http]) => ({
+ *     getUser: (id: string) => http.get(`/users/${id}`),
+ *     saveUser: (data: UserData) => http.post('/users', data),
+ *   }),
+ * })
+ * userRepo.register(appContainer)
+ */
+declare function defineRepository<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineRepositoryOptions<Deps, T>): RepositoryDefinition<T, Deps>;
+
+/**
+ * Дескриптор слота — host-агностичен: имя + непрозрачный `view` + опциональные `units`.
+ *
+ * `view` типизирован как `unknown` — ядро не знает про React/Vue: рендерит его view-адаптер
+ * (`Slot` из `@foxford/den-react`). Слот — самостоятельная `define*`-единица: любой пакет
+ * экспортит его напрямую, а размещением управляет оркестратор (не `definePage`).
+ */
+interface SlotDefinition {
+    /** Дискриминатор типа. */
+    readonly __type: 'slot';
+    /** Имя слота — по нему оркестратор решает, чем и куда его заполнить. */
+    readonly name: string;
+    /** Непрозрачная ссылка на view слота (компонент view-фреймворка). */
+    readonly view: unknown;
+    /** Data/Business единицы слота (изолированная секция). */
+    readonly units: readonly Definition<unknown>[];
+    /**
+     * Регистрирует единицы слота и кладёт сам слот в `SlotRegistry` контейнера.
+     * @param container - Контейнер (острова/страницы/запроса)
+     */
+    register(container: Container): void;
+}
+/** Опции `defineSlot`. */
+interface DefineSlotOptions {
+    /** Имя слота. */
+    name: string;
+    /** Непрозрачная ссылка на view слота. */
+    view: unknown;
+    /** Data/Business единицы слота (по умолчанию пусто). */
+    units?: readonly Definition<unknown>[];
+}
+/**
+ * Объявляет слот — самостоятельную `define*`-единицу расширения.
+ *
+ * `register(container)` регистрирует `units` и добавляет `{ name, view }` в `SlotRegistry`
+ * контейнера (get-or-create). Оркестратор потом резолвит реестр и решает, чем/куда
+ * заполнить слот. Рендерит слот view-адаптер (`Slot` из `@foxford/den-react`).
+ *
+ * @param options - Имя, непрозрачный `view` и опциональные `units`
+ * @returns Дескриптор `SlotDefinition`
+ *
+ * @example
+ * // любой пакет — экспортит слот-юнит, не зная, куда он смонтируется
+ * export const asideSlot = defineSlot({ name: 'market:aside', view: AsideView })
+ */
+declare function defineSlot({ name, view, units }: DefineSlotOptions): SlotDefinition;
+
+export { type AppConfig as A, type DefineGuardOptions as D, type ExtensionConfig as E, type GuardDefinition as G, type LayoutConfig as L, type RepositoryDefinition as R, type ServiceDefinition as S, type ViewModelDefinition as V, type DefineAppOptions as a, type AppDefinition as b, type DefineExtensionOptions as c, type ExtensionDefinition as d, type ActionGuard as e, type DefineActionGuardOptions as f, type ActionGuardDefinition as g, type DefineLayoutOptions as h, type LayoutDefinition as i, type LayerConfig as j, type DefineLayerOptions as k, type LayerDefinition as l, type DefineRepositoryOptions as m, type DefineServiceOptions as n, type DefineSlotOptions as o, type DefineViewModelOptions as p, type Definition as q, type SlotDefinition as r, defineRepository as s, defineService as t, defineSlot as u, defineViewModel as v };