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

#pragma once

#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "GGS_SocketRelationshipMapping.generated.h"

/**
 * Structure for socket adjustments.
 * 插槽调整结构。
 */
USTRUCT(BlueprintType)
struct GENERICGAMESYSTEM_API FGGS_SocketAdjustment
{
	GENERATED_BODY()

	/**
	 * Array of skeleton names for the adjustment.
	 * 调整适用的骨骼名称数组。
	 */
	UPROPERTY(EditAnywhere, Category="GGS")
	TArray<FString> ForSkeletons;

	/**
	 * Name of the socket.
	 * 插槽名称。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
	FName SocketName{NAME_None};

	/**
	 * Relative transform for the socket.
	 * 插槽的相对变换。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
	FTransform RelativeTransform;

#if WITH_EDITORONLY_DATA
	/**
	 * Editor-friendly name for the adjustment.
	 * 调整的编辑器友好名称。
	 */
	UPROPERTY(EditAnywhere, Category="GGS", meta=(EditCondition=false, EditConditionHides))
	FString EditorFriendlyName;
#endif
};

/**
 * Structure for socket relationships.
 * 插槽关系结构。
 */
USTRUCT(BlueprintType)
struct GENERICGAMESYSTEM_API FGGS_SocketRelationship
{
	GENERATED_BODY()

	/**
	 * Mesh asset associated with the relationship.
	 * 与关系关联的网格资产。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
	TSoftObjectPtr<UStreamableRenderAsset> MeshAsset;

	/**
	 * Array of socket adjustments for the mesh.
	 * 网格的插槽调整数组。
	 * @note Will look from bottom to top; 从下往上查询。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS", meta=(TitleProperty="EditorFriendlyName"))
	TArray<FGGS_SocketAdjustment> Adjustments;

#if WITH_EDITORONLY_DATA
	/**
	 * Editor-friendly name for the relationship.
	 * 关系的编辑器友好名称。
	 */
	UPROPERTY(EditAnywhere, Category="GGS", meta=(EditCondition=false, EditConditionHides))
	FString EditorFriendlyName;
#endif
};

/**
 * Data asset for defining socket relationships for mesh attachments.
 * 定义网格附件插槽关系的数据资产。
 */
UCLASS(BlueprintType)
class GENERICGAMESYSTEM_API UGGS_SocketRelationshipMapping : public UDataAsset
{
	GENERATED_BODY()

public:
	/**
	 * Finds a socket adjustment for a given mesh and socket.
	 * 查找给定网格和插槽的插槽调整。
	 * @param InParentMeshComponent The parent mesh component. 父网格组件。
	 * @param InMeshAsset The mesh asset. 网格资产。
	 * @param InSocketName The socket name. 插槽名称。
	 * @param OutAdjustment The found socket adjustment (output). 找到的插槽调整（输出）。
	 * @return True if an adjustment was found, false otherwise. 如果找到调整返回true，否则返回false。
	 */
	UFUNCTION(BlueprintCallable, BlueprintPure=False, Category="GGS|Utilities")
	bool FindSocketAdjustment(const USkeletalMeshComponent* InParentMeshComponent, const UStreamableRenderAsset* InMeshAsset, FName InSocketName,
	                          FGGS_SocketAdjustment& OutAdjustment) const;

	/**
	 * Finds a socket adjustment across multiple mappings.
	 * 在多个映射中查找插槽调整。
	 * @param InMappings The socket relationship mappings. 插槽关系映射。
	 * @param InParentMeshComponent The parent mesh component. 父网格组件。
	 * @param InMeshAsset The mesh asset. 网格资产。
	 * @param InSocketName The socket name. 插槽名称。
	 * @param OutAdjustment The found socket adjustment (output). 找到的插槽调整（输出）。
	 * @return True if an adjustment was found, false otherwise. 如果找到调整返回true，否则返回false。
	 */
	UFUNCTION(BlueprintCallable, Category="GGS|Utilities")
	static bool FindSocketAdjustmentInMappings(TArray<TSoftObjectPtr<UGGS_SocketRelationshipMapping>> InMappings, const USkeletalMeshComponent* InParentMeshComponent,
	                                           const UStreamableRenderAsset* InMeshAsset, FName InSocketName,
	                                           FGGS_SocketAdjustment& OutAdjustment);

	/**
	 * Array of socket relationships.
	 * 插槽关系数组。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS", meta=(TitleProperty="EditorFriendlyName"))
	TArray<FGGS_SocketRelationship> Relationships;

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