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

#pragma once

#include "CoreMinimal.h"
#include "GCS_TraceStructLibrary.h"
#include "Kismet/BlueprintFunctionLibrary.h"
#include "GCS_TraceFunctionLibrary.generated.h"

/**
 * Blueprint function library for trace system utilities.
 * 碰撞检测系统工具的蓝图函数库。
 */
UCLASS()
class GENERICCOMBATSYSTEM_API UGCS_TraceFunctionLibrary : public UBlueprintFunctionLibrary
{
	GENERATED_BODY()

public:
	/**
	 * Filter definitions with trace tag matches TagToMatch.
	 * 筛选与指定标签匹配的碰撞检测定义。
	 * @param Definitions The definitions to filter. 要筛选的定义。
	 * @param TagToMatch The tag to check. 要检查的标签。
	 * @return Matching definitions. 匹配的定义。
	 */
	UFUNCTION(BlueprintCallable, BlueprintPure, Category = "GCS|TraceSystem|Utilities", Meta = (DefaultToSelf="Actor"))
	static TArray<FGCS_TraceDefinition> FilterTraceDefinitionsByTag(const TArray<FGCS_TraceDefinition>& Definitions, const FGameplayTag& TagToMatch);
};