// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.

#pragma once

#include "GameplayTagContainer.h"
#include "GES_ContextEffectsEnumLibrary.h"
#include "UObject/SoftObjectPath.h"
#include "Engine/DataAsset.h"
#include "UObject/WeakObjectPtr.h"
#include "GES_ContextEffectsStructLibrary.h"
#include "GES_ContextEffectsLibrary.generated.h"

class UNiagaraSystem;
class USoundBase;
struct FFrame;

/**
 * Instance of context effects for runtime use.
 * 用于运行时的情景效果实例。
 */
UCLASS(DisplayName="GES Context Effects Instance")
class GENERICEFFECTSSYSTEM_API UGES_ActiveContextEffects : public UObject
{
	GENERATED_BODY()

public:
	/**
	 * Tag identifying the effect.
	 * 标识效果的标签。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	FGameplayTag EffectTag;

	/**
	 * Query for source tags.
	 * 源标签查询。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	FGameplayTagQuery SourceTagQuery;

	/**
	 * Query for target tags.
	 * 目标标签查询。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	FGameplayTagQuery TargetTagQuery;

	/**
	 * Array of sound assets for the effect.
	 * 效果的音效资产数组。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	TArray<TObjectPtr<USoundBase>> Sounds;

	/**
	 * Array of Niagara systems for the effect.
	 * 效果的Niagara系统数组。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	TArray<TObjectPtr<UNiagaraSystem>> NiagaraSystems;

	/**
	 * Array of particle systems for the effect.
	 * 效果的粒子系统数组。
	 */
	UPROPERTY(VisibleAnywhere, Category="GES")
	TArray<TObjectPtr<UParticleSystem>> ParticleSystems;
};

DECLARE_DYNAMIC_DELEGATE_OneParam(FGES_ContextEffectLibraryLoadingComplete, TArray<UGES_ActiveContextEffects *>, ActiveContextEffects);

/**
 * Data asset containing context effects definitions.
 * 包含情景效果定义的数据资产。
 */
UCLASS(BlueprintType)
class GENERICEFFECTSSYSTEM_API UGES_ContextEffectsLibrary : public UDataAsset
{
	GENERATED_BODY()

public:
	/**
	 * Array of context effects definitions.
	 * 情景效果定义数组。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "GES", meta = (TitleProperty="EditorFriendlyName"))
	TArray<FGES_ContextEffects> ContextEffects;

	/**
	 * Retrieves effects for a given tag and context.
	 * 获取指定标签和情景的效果。
	 * @param Effect The effect tag. 效果标签。
	 * @param SourceContext The source context tags. 源情景标签。
	 * @param TargetContext The target context tags. 目标情景标签。
	 * @param Sounds The sound assets (output). 音效资产（输出）。
	 * @param NiagaraSystems The Niagara systems (output). Niagara系统（输出）。
	 * @param ParticleSystems The particle systems (output). 粒子系统（输出）。
	 */
	UFUNCTION(BlueprintCallable, Category="GES|ContextEffect")
	void GetEffects(const FGameplayTag Effect, const FGameplayTagContainer& SourceContext, const FGameplayTagContainer& TargetContext, TArray<USoundBase*>& Sounds,
	                TArray<UNiagaraSystem*>& NiagaraSystems, TArray<UParticleSystem*>& ParticleSystems);

	/**
	 * Loads the effects in the library.
	 * 加载库中的效果。
	 */
	UFUNCTION(BlueprintCallable, Category="GES|ContextEffect")
	void LoadEffects();

	/**
	 * Retrieves the load state of the effects library.
	 * 获取效果库的加载状态。
	 * @return The load state. 加载状态。
	 */
	EGES_ContextEffectsLibraryLoadState GetContextEffectsLibraryLoadState();

private:
	/**
	 * Internal method for loading effects.
	 * 加载效果的内部方法。
	 */
	void LoadEffectsInternal();

	/**
	 * Called when effect library loading is complete.
	 * 效果库加载完成时调用。
	 * @param InActiveContextEffects The loaded context effects. 已加载的情景效果。
	 */
	void OnContextEffectLibraryLoadingComplete(TArray<UGES_ActiveContextEffects*> InActiveContextEffects);

	/**
	 * Array of active context effects.
	 * 活跃情景效果数组。
	 */
	UPROPERTY(Transient)
	TArray<TObjectPtr<UGES_ActiveContextEffects>> ActiveContextEffects;

	/**
	 * Current load state of the effects library.
	 * 效果库的当前加载状态。
	 */
	UPROPERTY(Transient)
	EGES_ContextEffectsLibraryLoadState EffectsLoadState = EGES_ContextEffectsLibraryLoadState::Unloaded;

#if WITH_EDITOR
	/**
	 * Pre-save processing for editor.
	 * 编辑器预保存处理。
	 */
	virtual void PreSave(FObjectPreSaveContext SaveContext) override;
#endif
};