package com.saga.sagalorestats.api ;

import com.saga.sagalorestats.SagaLoreStats ;
import com.saga.sagalorestats.attribute.AttributeData ;
import com.saga.sagalorestats.attribute.AttributeType ;
import com.saga.sagalorestats.script.api.AttributeAPI ;
import org.bukkit.Bukkit ;
import org.bukkit.entity.LivingEntity ;
import org.bukkit.entity.Player ;
import org.bukkit.plugin.Plugin ;

import java.util.List ;
import java.util.Map ;

/**
* SagaLoreStats Public API Interface
* Provides unified API interface for other plugins to call
*
* Usage Examples:
* ```java
* // Get player attribute value
* double attack = SagaLoreStatsAPI.getPlayerAttributeValue(player, "attack");
*
* // Add temporary attributes
* List<String> attributes = Arrays.asList("Attack: +50", "Health: +100");
* SagaLoreStatsAPI.addTemporaryAttributes(player, "Temporary BUFF", attributes);
*
* // Remove temporary attributes
* SagaLoreStatsAPI.removeTemporaryAttributes(player, "Temporary BUFF");
* ```
*/
public class SagaLoreStatsAPI {
 
    private static SagaLoreStats plugin ;
 
    /**
     * Initialize API (called internally by plugin)
     * @param plugin Plugin instance
     */
    public static void init (SagaLoreStats plugin ) ;
 
    /**
     * Get plugin instance
     * @return Plugin instance, returns null if plugin is not enabled
     */
    public static SagaLoreStats getPlugin ( ) ;
 
    /**
     * Check if plugin is available
     * @return Whether plugin is available
     */
    public static boolean isAvailable ( ) ;
 
    // ==================== Player Attribute API ====================
 
    /**
     * Get player attribute value (includes equipment attributes and script API attributes)
     * @param player Player
     * @param attributeKey Attribute key (e.g.: "attack", "defense", "health", etc.)
     * @return Attribute value, returns 0.0 if attribute doesn't exist
     */
    public static double getPlayerAttributeValue (Player player, String attributeKey ) ;

    /**
     * Get all player attributes (includes equipment attributes and script API attributes)
     * @param player Player
     * @return Attribute mapping, key is attribute key, value is attribute value
     */
    public static Map < String, Double > getPlayerAttributes (Player player ) ;

    /**
     * Get player combat power
     * @param player Player
     * @return Combat power value
     */
    public static double getPlayerCombatPower (Player player ) ;
 
    // ==================== Entity Attribute API ====================
 
    /**
     * Get entity attribute value (supports players and monsters)
     * @param entity Entity
     * @param attributeKey Attribute key
     * @return Attribute value, returns 0.0 if attribute doesn't exist
     */
    public static double getEntityAttributeValue (LivingEntity entity, String attributeKey ) ;

    /**
     * Get all entity attributes (supports players and monsters)
     * @param entity Entity
     * @return Attribute mapping, key is attribute key, value is attribute value
     */
    public static Map < String, Double > getEntityAttributes (LivingEntity entity ) ;
 
    // ==================== Temporary Attribute API ====================
 
    /**
     * Add temporary attribute source to entity
     * @param entity Entity
     * @param sourceName Attribute source name (used for identification and removal)
     * @param attributes Attribute list, format like ["Attack: +50", "Health: +100"]
     */
    public static void addTemporaryAttributes (LivingEntity entity, String sourceName, List <String > attributes ) ;
 
    /**
     * Remove temporary attribute source from entity
     * @param entity Entity
     * @param sourceName Attribute source name
     */
    public static void removeTemporaryAttributes (LivingEntity entity, String sourceName ) ;
 
    /**
     * Get all temporary attribute sources of entity
     * @param entity Entity
     * @return Attribute source mapping, key is source name, value is attribute list
     */
    public static Map < String, List <String >> getTemporaryAttributeSources (LivingEntity entity ) ;
 
    /**
     * Clear all temporary attribute sources of entity
     * @param entity Entity
     */
    public static void clearTemporaryAttributes (LivingEntity entity ) ;
 
    // ==================== Attribute Registration API ====================
 
    /**
     * Dynamically register script attribute
     * @param attributeKey Attribute key
     * @param attributeName Attribute name
     * @param attributeType Attribute type
     * @param priority Priority
     * @param combatPower Combat power coefficient
     * @param placeholder PlaceholderAPI placeholder
     */
    public static void registerScriptAttribute ( String attributeKey, String attributeName,
                                             AttributeType attributeType, int priority,
                                              double combatPower, String placeholder ) ;
 
    /**
     * Unregister script attribute
     * @param attributeKey Attribute key
     */
    public static void unregisterScriptAttribute ( String attributeKey ) ;
 
    // ==================== Attribute Data API ====================
 
    /**
     * Get attribute data
     * @param attributeKey Attribute key
     * @return Attribute data, returns null if doesn't exist
     */
    public static AttributeData getAttributeData ( String attributeKey ) ;
 
    /**
     * Get all attribute data
     * @return Attribute data mapping, key is attribute key, value is attribute data
     */
    public static Map < String, AttributeData > getAllAttributeData ( ) ;
 
    /**
     * Get attribute data by specified type
     * @param type Attribute type
     * @return Attribute data list
     */
    public static List <AttributeData > getAttributeDataByType (AttributeType type ) ;
 
    // ==================== Cache Management API ====================
 
    /**
     * Clear player attribute cache
     * @param player Player
     */
    public static void clearPlayerCache (Player player ) ;
 
    /**
     * Force refresh player attribute cache
     * @param player Player
     */
    public static void refreshPlayerAttributes (Player player ) ;
 
    /**
     * Force refresh all online players' attribute cache
     */
    public static void refreshAllPlayersAttributes ( ) ;
 
    // ==================== Utility Method API ====================
 
    /**
     * Calculate attribute effect
     * @param attributeKey Attribute key
     * @param attacker Attacker
     * @param entity Defender
     * @param attackerDamage Damage dealt by attacker
     * @param entityDamage Damage dealt by defender
     * @param value Attribute value
     * @return Calculation result
     */
    public static double calculateAttributeEffect ( String attributeKey, LivingEntity attacker,
                                                LivingEntity entity, double attackerDamage,
                                                double entityDamage, double value ) ;
 
    /**
     * Update player attributes
     * @param player Player
     */
    public static void updatePlayerAttributes (Player player ) ;
}