/// Represents the type of a function in the context of getter and setter methods.
///
/// # Variants
/// - `Get` - Represents a getter function.
/// - `GetMut` - Represents a mutable getter function.
/// - `Set` - Represents a setter function.
/// - `Debug` - Represents a debug function.
/// - `New` - Represents a constructor function.
/// - `Unknown` - Represents an unknown or unspecified function type.
#[derive(Clone, Copy, Debug, Default, Eq, Hash, PartialEq)]
pub(crate) enum FuncType {
    /// Represents a getter function.
    Get,
    /// Represents a mutable getter function.
    GetMut,
    /// Represents a setter function.
    Set,
    /// Represents a debug function.
    Debug,
    /// Represents a constructor function.
    New,
    /// Represents an unknown or unspecified function type.
    #[default]
    Unknown,
}

/// Represents the different parameter type strategies for setter methods.
///
/// This enum defines the strategies for determining parameter types
/// and assignment expressions in setter methods.
///
/// # Variants
/// - `Direct` - Uses the field type directly.
/// - `AsRef` - Uses `impl AsRef<T>` trait bound for parameter conversion.
/// - `Into` - Uses `impl Into<T>` trait bound for parameter conversion.
/// - `AsMut` - Uses `impl AsMut<T>` trait bound for parameter conversion.
/// - `Deref` - Uses `impl Deref<T>` trait bound for parameter conversion.
/// - `Custom` - Uses a custom trait bound specified by the user.
#[derive(Clone, Debug)]
pub(crate) enum ParameterType {
    /// Uses the field type directly.
    Direct,
    /// Uses `impl AsRef<T>` trait bound for parameter conversion.
    AsRef,
    /// Uses `impl Into<T>` trait bound for parameter conversion.
    Into,
    /// Uses `impl AsMut<T>` trait bound for parameter conversion.
    AsMut,
    /// Uses `impl Deref<T>` trait bound for parameter conversion.
    Deref,
    /// Uses a custom trait bound specified by the user.
    Custom(String),
}

/// Represents the return type behavior for getter methods.
///
/// This enum defines how getter methods should return values,
/// controlling whether they return references, cloned values.
///
/// # Variants
/// - `Reference` - Returns a reference to the field value (`&T`).
/// - `Clone` - Returns a cloned copy of the field value (`T`).
/// - `Copy` - Returns a copy of the field value for types implementing Copy trait (`self.field`).
/// - `Deref` - Returns a dereferenced value of the field (`*field`), with match control for Option/Result.
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
pub(crate) enum ReturnType {
    /// Returns a reference to the field value (`&T`).
    #[default]
    Reference,
    /// Returns a cloned copy of the field value (`T`).
    Clone,
    /// Returns a copy of the field value for types implementing Copy trait (`self.field`).
    Copy,
    /// Returns a dereferenced value of the field (`*field`), with match control for Option/Result.
    Deref,
}
