// Copyright © Gamesmiths Guild.

#if TOOLS
using System;
using Gamesmiths.Forge.Godot.Resources.Statescript;
using Godot;

namespace Gamesmiths.Forge.Godot.Editor.Statescript;

/// <summary>
/// Base class for all Statescript property resolver editor controls. Extends <see cref="PanelContainer"/> so it can be
/// added directly to the graph node UI and participates in the Godot scene tree (lifecycle, disposal, etc.).
/// </summary>
[Tool]
internal abstract partial class NodeEditorProperty : PanelContainer
{
	private Type[] _allowedExpectedTypes = [];

	/// <summary>
	/// Gets the display name shown in the resolver type dropdown (e.g., "Variable", "Constant", "Attribute").
	/// </summary>
	public abstract string DisplayName { get; }

	/// <summary>
	/// Gets the resolver type identifier string used for matching against serialized resources.
	/// </summary>
	public abstract string ResolverTypeId { get; }

	/// <summary>
	/// Checks whether this resolver is compatible with the given expected type.
	/// </summary>
	/// <param name="expectedType">The type expected by the node's input property.</param>
	/// <returns><see langword="true"/> if this resolver can provide a value of the expected type.</returns>
	public abstract bool IsCompatibleWith(Type expectedType);

	/// <summary>
	/// Initializes the resolver editor UI. Called once after the control is created.
	/// </summary>
	/// <param name="graph">The current graph resource (for accessing variables, etc.).</param>
	/// <param name="property">The existing property binding to restore state from, or null for a new binding.</param>
	/// <param name="expectedType">The type expected by the node's input property.</param>
	/// <param name="onChanged">Callback invoked when the resolver configuration changes.</param>
	/// <param name="isArray">Whether the input expects an array of values.</param>
	public abstract void Setup(
		StatescriptGraph graph,
		StatescriptNodeProperty? property,
		Type expectedType,
		Action onChanged,
		bool isArray);

	/// <summary>
	/// Writes the current resolver configuration to the given property binding resource.
	/// </summary>
	/// <param name="property">The property binding to write to.</param>
	public abstract void SaveTo(StatescriptNodeProperty property);

	/// <summary>
	/// Raised when the editor's layout size has changed (e.g. nested resolver swap, foldable toggle) so that the owning
	/// <see cref="GraphNode"/> can call <see cref="Control.ResetSize"/>.
	/// </summary>
	public event Action? LayoutSizeChanged;

	/// <summary>
	/// Configures the concrete input types allowed for this editor when the surrounding context accepts more than one.
	/// </summary>
	/// <param name="allowedExpectedTypes">The allowed expected types.</param>
	public void ConfigureAllowedExpectedTypes(params Type[] allowedExpectedTypes)
	{
		_allowedExpectedTypes = allowedExpectedTypes;
	}

	/// <summary>
	/// Tries to provide a short inline summary for the current editor state when embedded in a collapsed foldout.
	/// </summary>
	/// <param name="summary">The inline summary, when available.</param>
	/// <returns><see langword="true"/> when an inline summary is available.</returns>
	public virtual bool TryGetInlineSummary(out string summary)
	{
		summary = string.Empty;
		return false;
	}

	/// <summary>
	/// Gets the preferred badge style for inline foldout summaries.
	/// </summary>
	public virtual InlineSummaryBadgeKind GetInlineSummaryBadgeKind()
	{
		return InlineSummaryBadgeKind.Resolver;
	}

	/// <summary>
	/// Tries to provide the graph-variable name represented by this editor or one of its nested editors for highlight
	/// propagation in folded summaries.
	/// </summary>
	/// <param name="variableName">The variable name, when available.</param>
	public virtual bool TryGetHighlightedVariableName(out string variableName)
	{
		variableName = string.Empty;
		return false;
	}

	/// <summary>
	/// Tries to provide the shared-variable identity represented by this editor or one of its nested editors for
	/// highlight propagation in folded summaries.
	/// </summary>
	/// <param name="sharedVariableSetPath">The shared-variable set path, when available.</param>
	/// <param name="variableName">The shared variable name, when available.</param>
	public virtual bool TryGetHighlightedSharedVariable(out string sharedVariableSetPath, out string variableName)
	{
		sharedVariableSetPath = string.Empty;
		variableName = string.Empty;
		return false;
	}

	/// <summary>
	/// Clears all delegate fields to prevent serialization issues during hot-reload. Called before the editor is
	/// serialized or freed.
	/// </summary>
	public virtual void ClearCallbacks()
	{
		LayoutSizeChanged = null;
	}

	/// <summary>
	/// Notifies listeners that the editor layout has changed size.
	/// </summary>
	protected void RaiseLayoutSizeChanged()
	{
		LayoutSizeChanged?.Invoke();
	}

	protected Type[] GetAllowedExpectedTypes(Type fallbackExpectedType)
	{
		return _allowedExpectedTypes.Length > 0 ? _allowedExpectedTypes : [fallbackExpectedType];
	}
}
#endif