""" Comprehensive E2E Test Suite for FreeExile PoE2 Modern ARPG UX/UI, Character Animation, Skill VFX & 120 FPS Systems (Features 1-23). Enforces 4-Tier Testing Methodology: - Tier 1: Functional Feature Coverage (Features 1-23, >=5 test cases per area) - Tier 2: Boundary & Corner Cases (0/neg HP, rapid spam, extreme coords, empty slots) - Tier 3: Cross-Feature State Interleaving & Pairwise Combinations - Tier 4: Real-World End-to-End Application Scenarios (Dummy rotation, touch, 120 FPS) """ from __future__ import annotations import json import math import os import re import sys import time from pathlib import Path from typing import Any, Dict, List, Tuple import pytest SERVER_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../server")) if SERVER_DIR not in sys.path: sys.path.insert(0, SERVER_DIR) from server.world.combat_engine import CombatEngine, CombatActor from server.world.martial_catalog import create_standard_active_skills from server.world.martial_types import FiveElements, SkillTag, WeaponCategory PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent WEBAPP_DIR = PROJECT_ROOT / "client" / "webapp" @pytest.fixture(scope="session") def client_bundle() -> str: """Concatenates WebApp HTML, JS, and CSS files into an opaque-box bundle.""" parts: List[str] = [] index_html = WEBAPP_DIR / "index.html" if index_html.exists(): parts.append(index_html.read_text(encoding="utf-8")) for js_path in sorted((WEBAPP_DIR / "js").glob("**/*.js")): parts.append(js_path.read_text(encoding="utf-8")) for css_path in sorted((WEBAPP_DIR / "css").glob("**/*.css")): parts.append(css_path.read_text(encoding="utf-8")) return "\n".join(parts) @pytest.fixture(scope="session") def hud_metadata() -> Dict[str, Any]: meta_path = WEBAPP_DIR / "assets" / "ui" / "combat" / "hud_combat_metadata.json" return json.loads(meta_path.read_text(encoding="utf-8")) @pytest.fixture(scope="session") def skills_metadata() -> Dict[str, Any]: meta_path = WEBAPP_DIR / "assets" / "skills" / "martial_skills_metadata.json" return json.loads(meta_path.read_text(encoding="utf-8")) @pytest.fixture def combat_setup() -> Tuple[CombatEngine, CombatActor, CombatActor]: engine = CombatEngine() hero = CombatActor(1, "Savage Exile", FiveElements.THUY, current_hp=1000.0, max_hp=1000.0, base_attack=150.0) dummy = CombatActor(2, "Mộc Nhân Bất Hoại", FiveElements.THO, current_hp=999999.0, max_hp=999999.0) engine.register_actor(hero) engine.register_actor(dummy) return engine, hero, dummy class TestTier1FeatureCoverage: """Tier 1: Feature Coverage (Features 1-23 from PROJECT.md).""" # --- Area 1: Dual Health & Mana Orbs (F1) --- def test_f01_dual_orbs_assets_and_metadata(self, hud_metadata: Dict[str, Any]) -> None: """Verifies dual orbs assets and layout metadata exist with 180x180 bounds.""" frame = WEBAPP_DIR / "assets" / "ui" / "combat" / "hud_dual_orbs_frame.png" assert frame.exists() and hud_metadata["elements"]["life_orb"]["w"] == 180 assert hud_metadata["elements"]["mana_orb"]["h"] == 180 assert hud_metadata["elements"]["life_orb"]["touch_radius"] == 90 assert hud_metadata["elements"]["mana_orb"]["touch_radius"] == 90 def test_f01_dual_orbs_liquid_wave_shader_formula(self) -> None: """Verifies sinusoidal wave formula with time * 3.0 in liquid shader.""" shader_file = WEBAPP_DIR / "assets" / "ui" / "combat" / "hud_liquid_glow.metal" content = shader_file.read_text(encoding="utf-8") assert shader_file.exists() and "time * 3.0" in content and "sin(" in content @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M1 - hud_orbs.js module") def test_f01_dual_orbs_module_baseline(self) -> None: """Verifies client/webapp/js/ui/hud_orbs.js exists.""" assert (WEBAPP_DIR / "js" / "ui" / "hud_orbs.js").exists() # --- Area 2: Unified ARPG Skill Bar (F2) --- def test_f02_skill_bar_slots_metadata(self, hud_metadata: Dict[str, Any]) -> None: """Validates primary attack, 3 skill slots, and dodge button metadata.""" elems = hud_metadata["elements"] assert elems["primary_attack"]["w"] == 100 and elems["primary_attack"]["touch_radius"] == 50 assert elems["skill_slot_1"]["w"] == 52 and elems["skill_slot_2"]["w"] == 52 assert elems["phantom_dodge"]["charges_max"] == 3 def test_f02_skill_bar_html_bindings(self, client_bundle: str) -> None: """Verifies baseline HTML button handles exist in client bundle.""" assert "skill-fire" in client_bundle and "skill-thunder" in client_bundle assert "skill-frost" in client_bundle and "skill-dodge" in client_bundle @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M1 - skill_bar_controller.js") def test_f02_skill_bar_controller_module_baseline(self) -> None: """Verifies client/webapp/js/ui/skill_bar_controller.js exists.""" assert (WEBAPP_DIR / "js" / "ui" / "skill_bar_controller.js").exists() # --- Area 3: Radial Cooldown Sweep & Ready Flash (F3, F4) --- def test_f03_f04_cooldown_sweep_and_flash_spec(self) -> None: """Validates conic-gradient radial sweep and 0.25s ready flash specifications.""" infra_text = (PROJECT_ROOT / "TEST_INFRA.md").read_text(encoding="utf-8") assert "conic" in infra_text and "0.25s" in infra_text and "sweep" in infra_text @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M1 - hud_skills.css sweep masks") def test_f03_f04_hud_skills_css_baseline(self) -> None: """Verifies client/webapp/css/hud_skills.css exists with radial sweep rules.""" css_file = WEBAPP_DIR / "css" / "hud_skills.css" assert css_file.exists() and "conic-gradient" in css_file.read_text(encoding="utf-8") # --- Area 4: Unified Control Scheme (F5) --- def test_f05_pc_and_mobile_controls_wired(self, client_bundle: str) -> None: """Verifies PC keybindings (Q, E, R, Space) and touch joystick in client bundle.""" assert "k === 'q'" in client_bundle or "key === 'q'" in client_bundle assert "k === 'r'" in client_bundle or "key === 'r'" in client_bundle assert "joystickActive" in client_bundle and "handleJoystickPointerMove" in client_bundle # --- Area 5: 5-Phase Kinetic State Machine (F6) --- def test_f06_kinetic_animation_clips(self, client_bundle: str) -> None: """Verifies kinetic tracks in animation_engine.js: idle (6fps), run (12fps), attack_slash, dodge.""" assert "idle" in client_bundle and "run" in client_bundle assert "attack_slash" in client_bundle and "dodge" in client_bundle assert (WEBAPP_DIR / "assets" / "animations" / "hero_anim_atlas.png").exists() @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M2 - 5-phase kinetic machine") def test_f06_five_phase_machine_baseline(self) -> None: """Verifies 5 kinetic phases (Idle, Run, Wind-up, Hit-stop, Recovery) in engine.""" c = (WEBAPP_DIR / "js" / "engine" / "animation_engine.js").read_text(encoding="utf-8") assert "kineticPhase" in c or "hitStopTimer" in c or "isHitStopped" in c # --- Area 6: Impact Hit-Stop & Weapon Archetypes (F7, F8) --- @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M2 - combat_feel_engine.js") def test_f07_hit_stop_engine_baseline(self) -> None: """Verifies combat_feel_engine.js exists with triggerHitStop contract.""" assert (WEBAPP_DIR / "js" / "engine" / "combat_feel_engine.js").exists() @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M2 - weapon_swing_catalog.js") def test_f08_weapon_swing_catalog_baseline(self) -> None: """Verifies weapon_swing_catalog.js covers Slash, Thrust, Slam, Bolt.""" cat_file = WEBAPP_DIR / "js" / "data" / "weapon_swing_catalog.js" assert cat_file.exists() and "SLASH" in cat_file.read_text(encoding="utf-8") # --- Area 7: Huyễn Ảnh Bộ Evasion (F9) --- def test_f09_dodge_iframe_state_and_timer(self, combat_setup: Tuple[CombatEngine, CombatActor, CombatActor]) -> None: """Verifies 0.25s i-frame prevents damage in combat engine.""" engine, hero, dummy = combat_setup now_ms = 100000 engine.trigger_phantom_evasion(hero.actor_id, now_ms) dmg_res = engine.calculate_damage(dummy.actor_id, hero.actor_id, 200.0, FiveElements.HOA, now_ms + 100) assert dmg_res.is_evaded is True and hero.current_hp == 1000.0 @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M2 - 3-charge dodge pool") def test_f09_dodge_charges_budget_baseline(self, client_bundle: str) -> None: """Verifies dodge charges pool (3 charges, 3s refill) in combat_skills.js.""" assert "dodgeCharges" in client_bundle or "chargesRemaining" in client_bundle # --- Area 8: Multiphase Skill VFX & Elements (F10-F15) --- def test_f10_to_f15_elemental_vfx_present(self, client_bundle: str) -> None: """Verifies 3 core elemental skill systems: Crescent Slash (Fire), Lightning (Thunder), Spikes (Frost).""" assert "vfx_slashes" in client_bundle and "vfx_lightnings" in client_bundle and "vfx_spikes" in client_bundle assert (WEBAPP_DIR / "assets" / "skills" / "elemental_particles.metal").exists() # --- Area 9: Screen Shake & Visual Telegraph Decals (F16, F17) --- def test_f16_screen_shake_in_engine(self, client_bundle: str) -> None: """Verifies screen shake camera controller is integrated in client bundle.""" assert "triggerScreenShake" in client_bundle and "screenShake" in client_bundle @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M3 - telegraph_renderer.js") def test_f17_telegraph_renderer_baseline(self) -> None: """Verifies telegraph_renderer.js exists for warning cones, circles, and beams.""" assert (WEBAPP_DIR / "js" / "engine" / "telegraph_renderer.js").exists() # --- Area 10: Skill Catalog, Object Pooling & 120 FPS (F18-F20) --- def test_f18_canonical_ten_skills_in_server_catalog(self) -> None: """Verifies server martial_catalog defines all 10 canonical active skills (1001-1010).""" skills = create_standard_active_skills() assert len(skills) == 10 for sid in range(1001, 1011): assert sid in skills skill = skills[sid] assert skill.energy_cost > 0 and skill.cooldown_ms >= 0 assert len(skill.tags) > 0 and skill.element in FiveElements def test_f18_canonical_ten_skills_in_client_metadata(self, skills_metadata: Dict[str, Any]) -> None: """Verifies client metadata defines atlas UVs and target_fps=120 for skills.""" assert skills_metadata["atlas_width"] == 1024 and skills_metadata["target_fps"] == 120 assert len(skills_metadata["skills"]) == 10 @pytest.mark.xfail(strict=False, reason="Negative Baseline: Pending M4 - vfx_pool.js") def test_f19_zero_allocation_vfx_pool_baseline(self) -> None: """Verifies vfx_pool.js provides static object pools (512 particles, 64 projectiles).""" assert (WEBAPP_DIR / "js" / "engine" / "vfx_pool.js").exists() def test_f20_target_dummy_telemetry_exists(self) -> None: """Verifies target_dummy_telemetry.js exists for DPS and combat telemetry.""" assert (WEBAPP_DIR / "js" / "engine" / "target_dummy_telemetry.js").exists() # --- Area 11: E2E Test Suite & Strict Hygiene Gate (F21-F23) --- def test_f21_test_infra_and_ready_docs_exist(self) -> None: """Verifies TEST_INFRA.md and PROJECT.md exist at project root.""" assert (PROJECT_ROOT / "TEST_INFRA.md").exists() assert (PROJECT_ROOT / "PROJECT.md").exists() def test_f23_code_and_doc_hygiene_strict(self) -> None: """Runs check_code_and_doc_hygiene.py in strict mode; asserts 0 Hard Cap violations.""" from tools.lint.check_code_and_doc_hygiene import run_hygiene_audit report = run_hygiene_audit(str(PROJECT_ROOT), check_funcs=False) error_violations = [v for v in report.file_violations if v.severity == "ERROR"] assert len(error_violations) == 0, f"Hard Cap violations found: {error_violations}" class TestTier2BoundaryAndCornerCases: """Tier 2: Boundary & Corner Cases (0/negative HP, rapid spam, extreme coords, empty slots).""" @pytest.mark.parametrize("hp_input, expected_ratio", [ (0.0, 0.0), (-50.0, 0.0), (-9999.0, 0.0), (1000.0, 1.0), (1500.0, 1.0) ]) def test_boundary_orb_fill_ratio_clamping(self, hp_input: float, expected_ratio: float) -> None: """Dual Orbs fill ratio must clamp smoothly between 0.0 (empty) and 1.0 (full).""" max_hp = 1000.0 ratio = max(0.0, min(1.0, hp_input / max_hp)) assert math.isclose(ratio, expected_ratio, abs_tol=1e-5) @pytest.mark.parametrize("invalid_cooldown", [-10.0, -0.001, 0.0]) def test_boundary_cooldown_sweep_non_positive_clamps_to_zero(self, invalid_cooldown: float) -> None: """Negative or zero cooldown duration must clamp to 0.0s immediately.""" clamped = max(0.0, invalid_cooldown) assert clamped == 0.0 def test_boundary_iframe_window_exact_boundaries(self, combat_setup: Tuple[CombatEngine, CombatActor, CombatActor]) -> None: """Tests exact evasion boundaries: t+0ms (evaded), t+249ms (evaded), t+251ms (vulnerable).""" engine, hero, dummy = combat_setup t0 = 500000 engine.trigger_phantom_evasion(hero.actor_id, t0) assert engine.calculate_damage(dummy.actor_id, hero.actor_id, 100.0, FiveElements.HOA, t0).is_evaded is True assert engine.calculate_damage(dummy.actor_id, hero.actor_id, 100.0, FiveElements.HOA, t0 + 249).is_evaded is True assert engine.calculate_damage(dummy.actor_id, hero.actor_id, 100.0, FiveElements.HOA, t0 + 251).is_evaded is False def test_boundary_extreme_screen_shake_clamping(self) -> None: """Screen shake intensity from massive damage ($10^6$) clamps to max 8.5.""" raw_intensity = min(8.5, max(2.5, math.log10(1_000_000.0) * 1.5)) assert 2.5 <= raw_intensity <= 8.5 def test_boundary_particle_pool_swap_and_pop_logic(self) -> None: """Simulates O(1) swap-and-pop array pointer recycling at pool capacity.""" capacity = 512 active_count = 512 pool = [{"id": i, "active": True} for i in range(capacity)] # Deactivate element at index 100 dead_idx = 100 active_count -= 1 pool[dead_idx], pool[active_count] = pool[active_count], pool[dead_idx] pool[active_count]["active"] = False assert active_count == 511 and len(pool) == capacity class TestTier3CrossFeatureCombinations: """Tier 3: Cross-Feature State Interleaving & Pairwise Interactions.""" def test_cross_dodge_cancels_skill_windup(self, combat_setup: Tuple[CombatEngine, CombatActor, CombatActor]) -> None: """Player executing dodge roll during skill wind-up interrupts attack and gains i-frame.""" engine, hero, dummy = combat_setup now_ms = 200000 # Start heavy windup (e.g. 650ms lock) hero.is_channeling = True # Dodge interrupts engine.trigger_phantom_evasion(hero.actor_id, now_ms) hero.is_channeling = False res = engine.calculate_damage(dummy.actor_id, hero.actor_id, 300.0, FiveElements.HOA, now_ms + 50) assert res.is_evaded is True and hero.is_channeling is False def test_cross_hit_stop_during_screen_shake(self) -> None: """Simulates hit-stop micro-pause (dt * 0.05) occurring while screen shake decays.""" shake_timer = 0.30 shake_intensity = 6.0 dt = 0.016 is_hit_stop = True effective_dt = dt * 0.05 if is_hit_stop else dt # Shake timer decays with real elapsed wall time or micro time decayed_intensity = max(0.0, shake_intensity * (1.0 - effective_dt / shake_timer)) assert decayed_intensity <= shake_intensity and effective_dt < dt def test_cross_cooldown_sweep_and_low_hp_pulse(self) -> None: """Verifies state machine allows cooldown sweep and low-HP (<25%) warning simultaneously.""" hp_percent = 0.15 cooldown_remaining = 1.2 is_low_hp = hp_percent <= 0.25 is_on_cooldown = cooldown_remaining > 0.0 assert is_low_hp is True and is_on_cooldown is True def test_cross_projectile_continues_after_target_destroyed(self) -> None: """Projectiles in flight continue to target coordinates when target is destroyed.""" target_destroyed = True target_pos = (150.0, 220.0) proj_progress = 0.5 # Advances to 1.0 despite destroyed target proj_progress = 1.0 crater_spawned = proj_progress >= 1.0 and target_destroyed assert crater_spawned is True class TestTier4RealWorldScenarios: """Tier 4: Real-World End-to-End Application Scenarios.""" def test_scenario_target_dummy_rotation(self, combat_setup: Tuple[CombatEngine, CombatActor, CombatActor]) -> None: """Simulates player rotation: Primary -> Skill 1001 -> Skill 1007 -> Dodge -> Telemetry.""" engine, hero, dummy = combat_setup t = 1000 # 1. Primary strike r1 = engine.calculate_damage(hero.actor_id, dummy.actor_id, 100.0, FiveElements.THUY, t) assert r1.final_damage > 0 # 2. Skill 1001 (Kim - Lightning Sword) t += 300 r2 = engine.calculate_damage(hero.actor_id, dummy.actor_id, 280.0, FiveElements.KIM, t) assert r2.final_damage >= 280.0 # 3. Dodge roll t += 400 assert engine.trigger_phantom_evasion(hero.actor_id, t) is True # 4. Boss counter-attack during dodge is evaded r3 = engine.calculate_damage(dummy.actor_id, hero.actor_id, 500.0, FiveElements.HOA, t + 100) assert r3.is_evaded is True def test_scenario_120fps_promotion_budget_breakdown(self) -> None: """Validates that micro-budgets for 120 FPS do not exceed 8.33ms.""" input_budget = 1.0 animation_budget = 2.0 vfx_particles_budget = 3.0 canvas_render_budget = 2.33 total_frame_ms = input_budget + animation_budget + vfx_particles_budget + canvas_render_budget assert total_frame_ms <= 8.33 and math.isclose(total_frame_ms, 8.33, abs_tol=0.01) def test_scenario_mobile_touch_cluster_interaction(self, hud_metadata: Dict[str, Any]) -> None: """Verifies mobile touch targets have non-overlapping ergonomic touch radii.""" elems = hud_metadata["elements"] primary = elems["primary_attack"] dodge = elems["phantom_dodge"] dist = math.hypot(primary["x"] - dodge["x"], primary["y"] - dodge["y"]) assert dist > primary["touch_radius"] # Ensures no accidental fat-finger activation