QuartzUIGASBindingComponent: declaration reference

#pragma once

#include "CoreMinimal.h"
#include "QuartzUIBindingScope.h"
#include "QuartzUIBindingComponentBase.h"
#include "QuartzUIGASConfig.h"

#include "QuartzUIGASBindingComponent.generated.h"

class ULocalPlayer;
class UQuartzUIGASBindingScope;
class UQuartzUIGASResolver;

/** High-level lifecycle state for the feature-owned GAS adapter component. */
UENUM(BlueprintType)
enum class EQuartzUIGASBindingComponentState : uint8
{
	Inactive,
	WaitingForLocalPlayer,
	WaitingForShell,
	Bound,
	Failed
};

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(
	FQuartzUIGASBindingComponentStateChanged,
	EQuartzUIGASBindingComponentState, PreviousState,
	EQuartzUIGASBindingComponentState, NewState);

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(
	FQuartzUIGASBindingComponentFailed,
	FName, ErrorCode);

/**
 * Feature-friendly GAS adapter for one exact local player.
 *
 * Add this component (or a project Blueprint subclass with optional policy
 * defaults) to a local PlayerController, HUD, pawn, or bounded owner chain.
 * GameFeatureAction_AddComponents can therefore own registration and teardown
 * without a project C++ module or custom target. The component owns only the
 * binding scope; the GameInstance subsystem keeps ownership of the retained
 * browser shell across map travel.
 */
UCLASS(BlueprintType, Blueprintable, ClassGroup = (QuartzUI),
	meta = (BlueprintSpawnableComponent, DisplayName = "QuartzUI GAS Binding"))
class QUARTZUIGAS_API UQuartzUIGASBindingComponent : public UQuartzUIBindingComponentBase
{
	GENERATED_BODY()

public:
	UQuartzUIGASBindingComponent();

	/** Requests binding now and keeps reconciling ordinary startup races. */
	UFUNCTION(BlueprintCallable, Category = "QuartzUI|GAS", meta = (DisplayName = "Activate GAS UI Binding"))
	bool ActivateGASBinding();

	/** Idempotently cancels retries and releases all GAS/UI subscriptions. */
	UFUNCTION(BlueprintCallable, Category = "QuartzUI|GAS", meta = (DisplayName = "Deactivate GAS UI Binding"))
	bool DeactivateGASBinding();

	/** Retries a failed or pending binding without recreating the component. */
	UFUNCTION(BlueprintCallable, Category = "QuartzUI|GAS", meta = (DisplayName = "Retry GAS UI Binding"))
	bool RetryGASBinding();

	UFUNCTION(BlueprintPure, Category = "QuartzUI|GAS")
	UQuartzUIGASBindingScope* GetBindingScope() const { return BindingScope; }

	UFUNCTION(BlueprintPure, Category = "QuartzUI|GAS")
	EQuartzUIGASBindingComponentState GetBindingState() const { return BindingState; }

	UPROPERTY(BlueprintAssignable, Category = "QuartzUI|GAS")
	FQuartzUIGASBindingComponentStateChanged OnBindingStateChanged;

	UPROPERTY(BlueprintAssignable, Category = "QuartzUI|GAS")
	FQuartzUIGASBindingComponentFailed OnBindingFailed;

	/** Optional aliases/policy overrides. Null performs zero-authoring automatic discovery. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|GAS")
	TObjectPtr<UQuartzUIGASConfig> Config;

	/** Observation is automatic; browser gameplay mutation remains an explicit policy choice. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|GAS")
	EQuartzUIGASBrowserAbilityActionPolicy BrowserAbilityActionPolicy =
		EQuartzUIGASBrowserAbilityActionPolicy::Disabled;

	/** Optional project resolver override; the generic exact-player resolver is the default. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|GAS")
	TSubclassOf<UQuartzUIGASResolver> ResolverClass;

protected:
	virtual bool ValidateBindingRequest(FName& OutError) const override;
	virtual bool HasLiveBinding() const override;
	virtual EQuartzUIBindingAttachResult AttachBinding(
		ULocalPlayer* LocalPlayer,
		UQuartzUIView* Shell,
		FName& OutError) override;
	virtual void ReleaseBinding() override;
	virtual void HandleBindingLifecycleStateChanged(
		EQuartzUIBindingComponentLifecycleState PreviousState,
		EQuartzUIBindingComponentLifecycleState NewState) override;
	virtual void HandleBindingFailure(FName ErrorCode) override;

private:
	void ReleaseScope();

	UFUNCTION()
	void HandleScopeStateChanged(
		EQuartzUIBindingScopeState PreviousState,
		EQuartzUIBindingScopeState NewState);

	UFUNCTION()
	void HandleScopeFailed(FName ErrorCode);

	UPROPERTY(Transient)
	TObjectPtr<UQuartzUIGASBindingScope> BindingScope;

	EQuartzUIGASBindingComponentState BindingState = EQuartzUIGASBindingComponentState::Inactive;
};