feat: implement war engine with unit types, battle mechanics, and logging

- Added types for war engine configuration, battle input, and outcomes. - Implemented core war unit classes for generals and cities, including combat logic. - Introduced utility functions for managing meta data and conflict resolution. - Developed tests for war triggers and battle resolution scenarios.
2025-12-30 10:25:48 +00:00
parent d599d94a7b
commit b0c4f84656
11 changed files with 2560 additions and 0 deletions
@@ -0,0 +1,143 @@
+import type { RandUtil } from '@sammo-ts/common';
+
+import type {
+    City,
+    General,
+    GeneralTriggerState,
+    Nation,
+} from '../domain/entities.js';
+import type { ActionLogger } from '../logging/actionLogger.js';
+import type { WarUnit } from './units.js';
+import { WarTriggerCaller } from './triggers.js';
+
+export interface WarActionContext<TriggerState extends GeneralTriggerState = GeneralTriggerState> {
+    general: General<TriggerState>;
+    nation?: Nation | null;
+    city?: City;
+    log?: ActionLogger;
+    rng?: RandUtil;
+}
+
+export interface WarActionModule<TriggerState extends GeneralTriggerState = GeneralTriggerState> {
+    getName?(): string;
+    getInfo?(): string;
+
+    getBattleInitTriggerList?(
+        context: WarActionContext<TriggerState>
+    ): WarTriggerCaller | null;
+
+    getBattlePhaseTriggerList?(
+        context: WarActionContext<TriggerState>
+    ): WarTriggerCaller | null;
+
+    onCalcStat?(
+        context: WarActionContext<TriggerState>,
+        statName: string,
+        value: number | [number, number],
+        aux?: unknown
+    ): number | [number, number];
+
+    onCalcOpposeStat?(
+        context: WarActionContext<TriggerState>,
+        statName: string,
+        value: number | [number, number],
+        aux?: unknown
+    ): number | [number, number];
+
+    getWarPowerMultiplier?(
+        context: WarActionContext<TriggerState>,
+        unit: WarUnit<TriggerState>,
+        oppose: WarUnit<TriggerState>
+    ): [number, number];
+}
+
+export class WarActionPipeline<
+    TriggerState extends GeneralTriggerState = GeneralTriggerState
+> {
+    // 전투용 iAction 파이프라인: 스탯/트리거/전투력 보정 흐름을 순서대로 적용한다.
+    private readonly modules: WarActionModule<TriggerState>[];
+
+    constructor(modules: Array<WarActionModule<TriggerState> | null | undefined>) {
+        this.modules = modules.filter(Boolean) as WarActionModule<TriggerState>[];
+    }
+
+    getBattleInitTriggerList(
+        context: WarActionContext<TriggerState>
+    ): WarTriggerCaller {
+        const caller = new WarTriggerCaller();
+        for (const module of this.modules) {
+            const triggers = module.getBattleInitTriggerList?.(context);
+            if (triggers) {
+                caller.merge(triggers);
+            }
+        }
+        return caller;
+    }
+
+    getBattlePhaseTriggerList(
+        context: WarActionContext<TriggerState>
+    ): WarTriggerCaller {
+        const caller = new WarTriggerCaller();
+        for (const module of this.modules) {
+            const triggers = module.getBattlePhaseTriggerList?.(context);
+            if (triggers) {
+                caller.merge(triggers);
+            }
+        }
+        return caller;
+    }
+
+    onCalcStat<T extends number | [number, number]>(
+        context: WarActionContext<TriggerState>,
+        statName: string,
+        value: T,
+        aux?: unknown
+    ): T {
+        let current: number | [number, number] = value;
+        for (const module of this.modules) {
+            if (!module.onCalcStat) {
+                continue;
+            }
+            current = module.onCalcStat(context, statName, current, aux);
+        }
+        return current as T;
+    }
+
+    onCalcOpposeStat<T extends number | [number, number]>(
+        context: WarActionContext<TriggerState>,
+        statName: string,
+        value: T,
+        aux?: unknown
+    ): T {
+        let current: number | [number, number] = value;
+        for (const module of this.modules) {
+            if (!module.onCalcOpposeStat) {
+                continue;
+            }
+            current = module.onCalcOpposeStat(context, statName, current, aux);
+        }
+        return current as T;
+    }
+
+    getWarPowerMultiplier(
+        context: WarActionContext<TriggerState>,
+        unit: WarUnit<TriggerState>,
+        oppose: WarUnit<TriggerState>
+    ): [number, number] {
+        let attack = 1;
+        let defence = 1;
+        for (const module of this.modules) {
+            if (!module.getWarPowerMultiplier) {
+                continue;
+            }
+            const [attMul, defMul] = module.getWarPowerMultiplier(
+                context,
+                unit,
+                oppose
+            );
+            attack *= attMul;
+            defence *= defMul;
+        }
+        return [attack, defence];
+    }
+}