Program Listing for File ZagalaSpecTextStep.h#

↰ Return to documentation for file (ZagalaSpec/Public/Step/ZagalaSpecTextStep.h)

// Copyright (c) 2026, Zagala Game Solutions. All rights reserved.

#pragma once

#include "CoreMinimal.h"
#include "UObject/NoExportTypes.h"
#include "TimerManager.h"
#include "Core/Interface/Step/ZagalaSpecConfigStep.h"
#include "Core/Interface/Step/ZagalaSpecExportableStep.h"
#include "Core/Interface/Step/ZagalaSpecImportableStep.h"
#include "Core/Interface/Step/ZagalaSpecStepClassAccessor.h"
#include "Core/Regex/ZagalaSpecCaptureGroupCustomizer.h"
#include "ZagalaSpecTextStep.generated.h"

class UZagalaSpecRegexStepEntry;

DECLARE_LOG_CATEGORY_EXTERN(LogZagalaSpecTextStep, Log, All);

UCLASS(Blueprintable, EditInlineNew, CollapseCategories, meta = (DisplayName = "ZagalaSpec Text Step"))
class ZAGALASPEC_API UZagalaSpecTextStep : public UObject, public IZagalaSpecConfigStep, public IZagalaSpecExportableStep, public IZagalaSpecImportableStep, public IZagalaSpecStepClassAccessor
{
    GENERATED_BODY()

public:
    UZagalaSpecTextStep(const FObjectInitializer& ObjectInitializer = FObjectInitializer::Get());


    virtual FZagalaSpecStepCreationData CreateStepData_Implementation() const override;


    virtual FString GetAsText_Implementation() const override;


    virtual void ResolveFromText_Implementation(const FString& Text) override;


    virtual UClass* GetStepClass_Implementation() const override;

    const FString& GetDefinition() const;
    void SetDefinition(const FString& NewDefinition);
    const TObjectPtr<UZagalaSpecCaptureGroupCustomizer>& GetCaptureGroupCustomizer() const;
    void SetCaptureGroupCustomizer(TObjectPtr<UZagalaSpecCaptureGroupCustomizer> NewCustomizer);

    void PerformMatching();

    void DiscardPreviousCaptureGroupValues();
    void PreservePreviousCaptureGroupValues();

#if WITH_EDITOR
    virtual void PostEditChangeProperty(FPropertyChangedEvent& PropertyChangedEvent) override;
    virtual EDataValidationResult IsDataValid(class FDataValidationContext& Context) const override;
#endif

protected:
    UPROPERTY(BlueprintReadOnly, EditAnywhere, Category = "Text Step")
    FString Definition;

    UPROPERTY(Transient, VisibleAnywhere, meta = (EditCondition = "bIsPerformingMatch", EditConditionHides, HideEditConditionToggle), Category = "Text Step")
    FString SearchingMatchText;

    UPROPERTY(AdvancedDisplay, NoClear, EditDefaultsOnly, Instanced, Category = "Text Step")
    TObjectPtr<UZagalaSpecCaptureGroupCustomizer> CaptureGroupCustomizer;

    UPROPERTY(AdvancedDisplay, EditDefaultsOnly, Category = "Text Step")
    bool bPreservePreviousCaptureGroupValues;

    UPROPERTY(AdvancedDisplay, VisibleAnywhere, Category = "Text Step")
    FSoftObjectPath MatchedStepEntry;

    UPROPERTY(Transient)
    bool bIsPerformingMatch;

private:
#if WITH_EDITOR
    void SetDebounceTimer();
    void ClearDebounceTimer();
    void OnDefinitionStabilized();
#endif

    FTimerHandle DebounceTimerHandle;
};