import type { Cell } from '../battlefield/Cell';
import type { IBattleBridge } from '../bridge/IBattleBridge';
import type { EntityId } from '../ecs/EntityId';
import type { BattleEventListener } from '../events/BattleEvents';
import type { BattleEventSubscription } from '../events/BattleEventType';
import { BattleFactory, type BattleCreateOptions } from './BattleFactory';
import type { BattleSession } from './BattleSession';

/** BattleHost 创建参数 */
export interface BattleHostOptions extends BattleCreateOptions {
    /** 项目层桥接 */
    bridge?: IBattleBridge;
}

/**
 * 通用战斗宿主 — 推荐入口。
 * 负责：创建会话、驱动 tick、订阅事件、结束战斗。
 */
export class BattleHost {
    /** 底层战斗会话 */
    readonly session: BattleSession;

    private constructor(session: BattleSession) {
        this.session = session;
    }

    /**
     * @param options 创建参数
     * @returns 已就绪的 BattleHost 实例
     */
    static open(options: BattleHostOptions): BattleHost {
        const session = BattleFactory.create(options);
        return new BattleHost(session);
    }

    /** @param dt 帧间隔（秒） */
    tick(dt: number): void {
        this.session.tick(dt);
    }

    /**
     * @param playerId 玩家 ID
     * @param unitDefId 单位配置 ID
     * @param cell 锚点格子
     * @returns 部署成功返回实体 ID
     */
    deploy(playerId: number, unitDefId: string, cell: Cell): EntityId | null {
        return this.session.deploy.place(playerId, unitDefId, cell);
    }

    /** 进入备战阶段 */
    startPrep(): void {
        this.session.startPrep();
    }

    /** 开始当前波战斗 */
    startCombat(): void {
        this.session.startCombat();
    }

    /**
     * @param event 事件类型或通配符
     * @param listener 回调
     */
    on(event: BattleEventSubscription, listener: BattleEventListener): void {
        this.session.events.on(event, listener);
    }

    /**
     * @param event 事件类型或通配符
     * @param listener 回调
     */
    off(event: BattleEventSubscription, listener: BattleEventListener): void {
        this.session.events.off(event, listener);
    }

    /**
     * @param reason 结束原因
     */
    destroy(reason = 'destroyed'): void {
        this.session.endBattle(false, reason);
    }
}