""" Tier 1: Feature Coverage — Animation FSM, Target Dummy, Dodge i-Frame & Boss Combat. Covers Features 7, 14, 15, 17 from PROJECT.md Feature Inventory: - Feature 7: Animation FSM & Motion Matching - Feature 14: Target Dummy Combat & Combos - Feature 15: 0.25s i-frame Dodge Roll - Feature 17: Strand Executioner Boss & Loot """ from __future__ import annotations import math from typing import Any, Dict, List import pytest from tests.e2e_cocos.conftest import ( DODGE_BOOST, DODGE_IFRAME_DURATION, SimulatedCocosPlayer, resolve_heading_bin, ) class TestTier1AnimationFSMAndMotionMatching: """Feature 7: Animation FSM & Motion Matching.""" def test_t1_f7_eight_way_heading_bins(self) -> None: # In 2.5D isometric projection: # (1, -1) -> Screen East (0 deg) # (1, 0) -> Screen South-East (26.6 deg) # (1, 1) -> Screen South (90 deg) # (0, 1) -> Screen South-West (153.4 deg) # (-1, 1) -> Screen West (180 deg) # (-1, 0) -> Screen North-West (206.6 deg) # (-1, -1) -> Screen North (270 deg) # (0, -1) -> Screen North-East (333.4 deg) vectors_to_bin = [ (1.0, -1.0, "E"), (1.0, 0.0, "SE"), (1.0, 1.0, "S"), (0.0, 1.0, "SW"), (-1.0, 1.0, "W"), (-1.0, 0.0, "NW"), (-1.0, -1.0, "N"), (0.0, -1.0, "NE"), ] for dx, dy, expected_bin in vectors_to_bin: assert resolve_heading_bin(dx, dy) == expected_bin def test_t1_f7_bottom_center_pivot_offset(self) -> None: # Standard anchor [0.5, 0.90] for bottom-center sprite pivot frame_width, frame_height = 160.0, 192.0 pivot_x, pivot_y = 0.5, 0.90 anchor_px_x = frame_width * pivot_x anchor_px_y = frame_height * pivot_y assert anchor_px_x == 80.0 assert anchor_px_y == 172.8 def test_t1_f7_footstep_speed_scaling_formula(self) -> None: # playback_fps = base_fps * max(0.2, v / v_base) base_fps = 14.0 v_base = 4.2 # Normal speed (5.5) -> playback speed > base_fps playback_fps = base_fps * max(0.2, 5.5 / v_base) assert playback_fps > base_fps assert math.isclose(playback_fps, 18.333, abs_tol=1e-2) def test_t1_f7_footstep_keyframes_trigger(self) -> None: # Hero run triggers footstep events on frames 0 and 4 footstep_frames = {0, 4} triggered = [] for f in range(8): if f in footstep_frames: triggered.append(f) assert triggered == [0, 4] def test_t1_f7_atlas_clip_aliasing_global_index(self) -> None: # Clip aliasing attack_thrust -> attack_slash does not duplicate global frames manifest_clips = { "idle": {"frames": 8}, "run": {"frames": 8}, "attack_slash": {"frames": 6}, "attack_thrust": {"atlas_clip": "attack_slash"}, "dodge": {"frames": 4}, } total_frames = 0 for name, data in manifest_clips.items(): if "atlas_clip" not in data: total_frames += data["frames"] assert total_frames == 26 def test_t1_f7_fsm_valid_transitions(self, simulated_player: SimulatedCocosPlayer) -> None: assert simulated_player.anim_state == "idle" simulated_player.apply_input(1.0, 0.0, 0.016) assert simulated_player.anim_state == "run" simulated_player.trigger_dodge() assert simulated_player.anim_state == "dodge" simulated_player.update_timers(0.3) assert simulated_player.anim_state == "idle" class TestTier1TargetDummyAndCombos: """Feature 14: Target Dummy Combat & Combos.""" def test_t1_f14_dummy_immortality_and_health_clamp(self) -> None: dummy = {"hp": 80000, "max_hp": 80000, "isDummy": True} # Inflict lethal damage damage = 999999 dummy["hp"] = max(1, dummy["hp"] - damage) assert dummy["hp"] == 1 assert dummy["isDummy"] is True def test_t1_f14_three_step_combo_damage_multipliers(self) -> None: base_damage = 100.0 multipliers = [1.0, 1.3, 1.75] combo_damages = [base_damage * m for m in multipliers] assert combo_damages[0] == 100.0 assert combo_damages[1] == 130.0 assert combo_damages[2] == 175.0 def test_t1_f14_combo_streak_counter_and_timer_reset(self) -> None: combo_count = 0 last_hit_time = 0.0 combo_window = 2.0 # seconds # Hit 1 at t=0.5 combo_count += 1 last_hit_time = 0.5 # Hit 2 at t=1.2 (within window) if 1.2 - last_hit_time <= combo_window: combo_count += 1 last_hit_time = 1.2 assert combo_count == 2 # Hit 3 at t=4.0 (window expired: 4.0 - 1.2 = 2.8 > 2.0) if 4.0 - last_hit_time > combo_window: combo_count = 1 last_hit_time = 4.0 assert combo_count == 1 def test_t1_f14_rolling_dps_window_calculation(self) -> None: damage_log = [(0.1, 150), (0.5, 200), (1.0, 350), (1.8, 500)] window_duration = 2.0 total_dmg = sum(dmg for t, dmg in damage_log if t <= window_duration) dps = total_dmg / window_duration assert total_dmg == 1200 assert dps == 600.0 def test_t1_f14_hit_stop_micro_freeze_duration(self) -> None: # Hit-stop duration between 33ms and 66ms (2 to 4 frames at 60fps) hit_stop_ms = 45.0 assert 33.0 <= hit_stop_ms <= 66.0 def test_t1_f14_damage_text_pool_ring_buffer_64_slots(self) -> None: pool_size = 64 pool = [{"active": False, "val": 0} for _ in range(pool_size)] # Insert 70 numbers, slots must wrap safely modulo 64 for i in range(70): slot = pool[i % pool_size] slot["active"] = True slot["val"] = i assert len(pool) == pool_size assert pool[0]["val"] == 64 # Overwritten slot 0 class TestTier1PhantomEvasionDodge: """Feature 15: 0.25s i-frame Dodge Roll.""" def test_t1_f15_iframe_activation_and_duration(self, simulated_player: SimulatedCocosPlayer) -> None: assert not simulated_player.is_iframe simulated_player.trigger_dodge() assert simulated_player.is_iframe assert simulated_player.iframe_timer == DODGE_IFRAME_DURATION def test_t1_f15_speed_boost_multiplier_during_dodge(self, simulated_player: SimulatedCocosPlayer) -> None: simulated_player.trigger_dodge() simulated_player.apply_input(1.0, 0.0, dt=0.1) # Velocity must incorporate DODGE_BOOST expected_vx = 5.5 * DODGE_BOOST assert math.isclose(simulated_player.vx, expected_vx, abs_tol=1e-4) def test_t1_f15_invulnerability_cancels_damage(self, simulated_player: SimulatedCocosPlayer) -> None: simulated_player.trigger_dodge() incoming_damage = 50.0 # When is_iframe is True, applied damage is 0 actual_damage = 0.0 if simulated_player.is_iframe else incoming_damage assert actual_damage == 0.0 def test_t1_f15_iframe_expiration_restores_vulnerability(self, simulated_player: SimulatedCocosPlayer) -> None: simulated_player.trigger_dodge() assert simulated_player.is_iframe simulated_player.update_timers(0.26) assert not simulated_player.is_iframe def test_t1_f15_ghost_trail_particle_emission(self, simulated_player: SimulatedCocosPlayer) -> None: simulated_player.trigger_dodge() ghost_trails = [] # While dodging, emit trail at player's position if simulated_player.is_iframe: ghost_trails.append({"x": simulated_player.wx, "y": simulated_player.wy, "alpha": 0.8}) assert len(ghost_trails) == 1 assert ghost_trails[0]["alpha"] == 0.8 class TestTier1BossCombatAndLootFountain: """Feature 17: Strand Executioner Boss & Loot.""" def test_t1_f17_strand_executioner_canonical_stats(self) -> None: boss = { "id": "boss_strand_executioner", "name": "Đao Phủ Bờ Biển", "hp": 18500, "max_hp": 18500, "damage": 140, "poise": 300, } assert boss["hp"] == 18500 assert boss["damage"] == 140 def test_t1_f17_telegraph_progression_windup(self) -> None: windup_duration = 1.2 elapsed = 0.6 progress = min(1.0, elapsed / windup_duration) assert math.isclose(progress, 0.5, abs_tol=1e-4) def test_t1_f17_telegraph_stagger_instant_cancellation(self) -> None: telegraph = {"active": True, "type": "slam_circle", "progress": 0.8} boss_stagger = True if boss_stagger: telegraph["active"] = False assert not telegraph["active"] def test_t1_f17_loot_fountain_dispersion_arc(self) -> None: loot_items = ["blood_soul_orb", "nether_bone_nail", "blood_reaper_scythe"] boss_x, boss_y = 10.0, 10.0 drops = [] for i, item in enumerate(loot_items): angle = (2.0 * math.pi / len(loot_items)) * i dist = 1.5 + (i * 0.2) drop_x = boss_x + math.cos(angle) * dist drop_y = boss_y + math.sin(angle) * dist drops.append({"id": item, "x": drop_x, "y": drop_y}) assert len(drops) == 3 assert drops[0]["x"] != drops[1]["x"] def test_t1_f17_rarity_light_beam_colors(self) -> None: rarity_colors = { "COMMON": "#ffffff", "MAGIC": "#3b82f6", "RARE": "#f59e0b", "MYTHIC": "#ef4444", } assert rarity_colors["MAGIC"] == "#3b82f6" assert rarity_colors["MYTHIC"] == "#ef4444" def test_t1_f17_auto_pickup_radius_threshold(self) -> None: player_x, player_y = 5.0, 5.0 pickup_radius = 1.8 drop_near = {"x": 5.8, "y": 5.6} # dist = sqrt(0.64 + 0.36) = 1.0 <= 1.8 drop_far = {"x": 7.0, "y": 7.0} # dist = sqrt(4 + 4) = 2.82 > 1.8 assert math.hypot(drop_near["x"] - player_x, drop_near["y"] - player_y) <= pickup_radius assert math.hypot(drop_far["x"] - player_x, drop_far["y"] - player_y) > pickup_radius