// Package entity provides the core combat and magic systems for EverQuest II server emulation.
// It extends the base Spawn system with combat capabilities, spell effects, and character statistics management.
//
// Basic Usage:
//
//	entity := entity.NewEntity()
//	entity.GetInfoStruct().SetName("TestEntity")
//	entity.GetInfoStruct().SetLevel(50)
//	entity.GetInfoStruct().SetStr(100.0)
//
// Managing Spell Effects:
//
//	// Add a maintained spell (buff)
//	success := entity.AddMaintainedSpell("Heroic Strength", 12345, 300.0, 2)
//
//	// Add a temporary effect
//	entity.AddSpellEffect(54321, casterID, 60.0)
//
//	// Add a detrimental effect
//	entity.AddDetrimentalSpell(99999, attackerID, 30.0, 1)
//
// Stat Calculations:
//
//	// Get effective stats (base + bonuses)
//	str := entity.GetStr()
//	sta := entity.GetSta()
//	primary := entity.GetPrimaryStat()
//
//	// Recalculate all bonuses
//	entity.CalculateBonuses()
//
// Pet Management:
//
//	// Set a summon pet
//	entity.SetPet(petEntity)
//
//	// Check pet status
//	if entity.GetPet() != nil && !entity.IsPetDismissing() {
//		// Pet is active
//	}
package entity