// Copyright (c) 2026 Unreal Directive. Licensed under the MIT License.

#pragma once

#include "CoreMinimal.h"
#include "Tasks/DirectiveUtilAsyncActionBase.h"
#include "Engine/TimerHandle.h"
#include "DirectiveUtilTask_Delay.generated.h"

DECLARE_DYNAMIC_MULTICAST_DELEGATE(FOnDelayCompleted);

/**
 * DirectiveUtilTask_Delay
 * A cancellable delay.
 */
UCLASS(BlueprintType, meta=(ExposedAsyncProxy = AsyncTask, DisplayName="Cancellable Delay"))
class DIRECTIVEUTILITIESRUNTIME_API UDirectiveUtilTask_Delay : public UDirectiveUtilCancellableAsyncAction
{
	GENERATED_BODY()

public:

	/**
	 * Starts a cancellable delay.
	 * When the delay has completed, the Completed delegate is called.
	 * Call Cancel to stop the delay before it completes.
	 *
	 * @param WorldContextObject The world context object.
	 * @param Duration The duration of the delay in seconds. Non-finite and non-positive values complete on the next timer tick.
	 */
	UFUNCTION(
		BlueprintCallable,
		meta=(
			BlueprintInternalUseOnly = "true",
			Category = "Directive Utilities|FlowControl",
			WorldContext = "WorldContextObject",
			DisplayName = "Cancellable Delay"
			))
	static UDirectiveUtilTask_Delay* CancellableDelay(UObject* WorldContextObject, float Duration);

	UFUNCTION(BlueprintCallable, meta=(DeprecatedFunction, DeprecationMessage="Use Cancel instead."), Category = "Directive Utilities|FlowControl")
	void EndTask();
	virtual void Activate() override;
	virtual void Cancel() override;
	virtual bool IsActive() const override;
	virtual bool ShouldBroadcastDelegates() const override;

	UPROPERTY(BlueprintAssignable)
	FOnDelayCompleted Completed;

protected:

	UPROPERTY()
	TObjectPtr<UObject> WorldContextObject;

	float Duration = 0.0f;
	bool bFinished = false;
	FTimerHandle TimerHandle;

	void OnDelayComplete();
};