QuartzUIProjectContract: declaration reference

#pragma once

#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "QuartzUICoreContract.h"

#include "QuartzUIProjectContract.generated.h"

class UQuartzUIAppAsset;
class UQuartzUIProjectSettings;
class UQuartzUIProvider;
class UQuartzUIProviderSet;

/** One exact state/event/action payload DTO selected by a project asset. */
USTRUCT(BlueprintType)
struct QUARTZUIRUNTIME_API FQuartzUIProjectPayloadDeclaration
{
	GENERATED_BODY()

	/** Lowercase dotted wire name outside the reserved quartzui namespace. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	FName Name;

	/** Exact data-only USTRUCT reflected into TypeScript and checked at runtime. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TObjectPtr<UScriptStruct> PayloadType;
};

/** One exact browser-to-Unreal request plus its asynchronous result DTO. */
USTRUCT(BlueprintType)
struct QUARTZUIRUNTIME_API FQuartzUIProjectRequestDeclaration
{
	GENERATED_BODY()

	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	FName Name;

	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TObjectPtr<UScriptStruct> PayloadType;

	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TObjectPtr<UScriptStruct> ResultType;
};

/**
 * Project-owned explicit fragment of one app's browser contract.
 * Only these arrays are inspected; no UObject/class/asset-registry scan occurs.
 */
UCLASS(BlueprintType, meta = (DisplayName = "QuartzUI Project Contract"))
class QUARTZUIRUNTIME_API UQuartzUIProjectContractAsset final : public UDataAsset
{
	GENERATED_BODY()

public:
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TArray<FQuartzUIProjectPayloadDeclaration> States;

	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TArray<FQuartzUIProjectPayloadDeclaration> Events;

	/** One-way UI intent; native returns an empty acknowledgement after dispatch. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TArray<FQuartzUIProjectPayloadDeclaration> Actions;

	/** Validated request whose result may complete asynchronously. */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "QuartzUI|Contract")
	TArray<FQuartzUIProjectRequestDeclaration> Requests;

	UFUNCTION(BlueprintPure, Category = "QuartzUI|Contract")
	int32 GetDeclarationCount() const;
};

/** Fully merged immutable contract identity retained by one logical view. */
struct QUARTZUIRUNTIME_API FQuartzUIResolvedAppContract
{
	FQuartzUIContractManifest Manifest;
	FString ContractHash;
	bool bHasProjectContracts = false;
	TArray<TObjectPtr<UQuartzUIProjectContractAsset>> LoadedAssets;
	TArray<TObjectPtr<UClass>> LoadedProviderClasses;
	TArray<TObjectPtr<UQuartzUIProviderSet>> LoadedProviderSets;

	const FQuartzUIContractMessageDeclaration* Find(FName Name) const;
	bool IsExact(
		EQuartzUIContractMessageKind Kind,
		FName Name,
		const UScriptStruct* PayloadType,
		const UScriptStruct* ResultType = nullptr) const;
};

/** Explicit per-app loader, validator, merger, and effective-hash source. */
class QUARTZUIRUNTIME_API FQuartzUIProjectContractResolver final
{
public:
	static constexpr int32 MaxContractsPerApp = 16;
	static constexpr int32 MaxDeclarationsPerAsset = 64;

	/** Null app and an app with no fragments both resolve to the immutable core. */
	static bool TryResolve(
		const UQuartzUIAppAsset* App,
		FQuartzUIResolvedAppContract& OutContract,
		FString& OutError);

	/** Pure merge seam used by focused tests and project tooling. */
	static bool TryMerge(
		const TArray<const UQuartzUIProjectContractAsset*>& Contracts,
		FQuartzUIResolvedAppContract& OutContract,
		FString& OutError);

	/** Pure merge seam for explicit DTO fragments plus reflected providers. */
	static bool TryMerge(
		const TArray<const UQuartzUIProjectContractAsset*>& Contracts,
		const TArray<const UClass*>& Providers,
		FQuartzUIResolvedAppContract& OutContract,
		FString& OutError);

	/** Finds one explicitly configured app by canonical ID; no asset-registry scan occurs. */
	static bool TryFindConfiguredApp(
		const UQuartzUIProjectSettings& Settings,
		FName AppId,
		UQuartzUIAppAsset*& OutApp,
		FString& OutError);
};