import { type BaseModuleState } from './types';
/**
 * Хелпер для удобного описания типов compat модулей
 * @example (window as WindowWithModule).myAwesomeModule = { ... };
 */
export type WindowWithModule<ModuleType = unknown> = typeof window & {
    [key: string]: ModuleType;
};
export type ModuleMountFunction<RunParams = void, ServerState extends BaseModuleState = BaseModuleState> = (targetNode: HTMLElement, runParams: RunParams, serverState: ServerState) => void;
export type ModuleUnmountFunction = (targetNode: HTMLElement) => void;
/**
 * Специальный тип модуля, который можно монтировать на страницу
 * @template RunParams параметры, которые передаются в модуль с клиента
 * @template ServerState состояние модуля, которое пришло с сервера
 */
export type MountableModule<RunParams = void, ServerState extends BaseModuleState = BaseModuleState> = {
    /**
     * Метод, с помощью которого модуль может прикрепиться к DOM
     * @param targetNode DOM-нода, к которой нужно прикрепить модуль
     * @param runParams параметры, которые передаются в модуль с клиента
     * @param serverState состояние модуля, которое пришло с сервера
     */
    mount: ModuleMountFunction<RunParams, ServerState>;
    /**
     * Метод, с помощью которого модуль должен открепиться от DOM
     * @param targetNode DOM-нода, от которой нужно открепить модуль
     */
    unmount: ModuleUnmountFunction;
    /**
     * Опциональный метод: модуль должен "оживить" (hydrate) серверную разметку,
     * находящуюся внутри targetNode, вместо её замены.
     * Типичная реализация: ReactDOM.hydrateRoot(targetNode, <Component {...} />).
     *
     * Если метод отсутствует у серверно-отрендеренного модуля — mounter очищает outlet
     * и вызывает `mount()` (корректно, но с визуальным миганием).
     * @param targetNode DOM-нода с серверной разметкой модуля
     * @param runParams параметры, которые передаются в модуль с клиента
     * @param serverState состояние модуля, которое пришло с сервера
     */
    hydrate?: ModuleMountFunction<RunParams, ServerState>;
    /**
     * Опциональный метод: обновить уже смонтированный модуль новыми параметрами
     * без полного перемонтирования (не теряя фокус/состояние DOM).
     * Типичная реализация: root.render(<Component {...newParams} />).
     *
     * Если метод отсутствует — mounter сохраняет текущее поведение с перемонтированием
     * при изменении runParams.
     * @param targetNode DOM-нода, к которой прикреплён модуль
     * @param runParams новые параметры, которые передаются в модуль с клиента
     * @param serverState состояние модуля, которое пришло с сервера
     */
    update?: ModuleMountFunction<RunParams, ServerState>;
};
/**
 * Хелпер для удобного описания mountable compat модулей
 */
export type WindowWithMountableModule = WindowWithModule<MountableModule>;
/**
 * Специальный тип модуля, который является фабрикой
 * @template ServerState состояние модуля, которое пришло с сервера
 * @template RunParams параметры, которые передаются в модуль с клиента
 * @template ReturnType тип, который возвращает фабрика
 */
export type FactoryModuleFunction<ReturnType = any, RunParams = void, ServerState extends BaseModuleState = BaseModuleState> = {
    (runParams: RunParams, serverState: ServerState): ReturnType;
};
export type FactoryModule<ReturnType = any, RunParams = void, ServerState extends BaseModuleState = BaseModuleState> = FactoryModuleFunction<ReturnType, RunParams, ServerState> | {
    factory: FactoryModuleFunction<ReturnType, RunParams, ServerState>;
    mount: never;
} | {
    mount: FactoryModuleFunction<ReturnType, RunParams, ServerState>;
    factory: never;
};
export type WindowWithFactoryModule = WindowWithModule<FactoryModule>;