package net.tnemc.item.paper;

/*
 * The New Item Library
 * Copyright (C) 2022 - 2025 Daniel "creatorfromhell" Vidmar
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

import net.kyori.adventure.text.Component;
import net.tnemc.item.AbstractItemStack;
import net.tnemc.item.component.SerialComponent;
import net.tnemc.item.component.helper.AttributeModifier;
import net.tnemc.item.component.helper.BlockPredicate;
import net.tnemc.item.component.helper.EquipSlot;
import net.tnemc.item.component.helper.ExplosionData;
import net.tnemc.item.component.helper.ItemDamage;
import net.tnemc.item.component.helper.PatternData;
import net.tnemc.item.component.helper.ToolRule;
import net.tnemc.item.component.helper.effect.ComponentEffect;
import net.tnemc.item.component.helper.effect.EffectInstance;
import net.tnemc.item.component.impl.AttributeModifiersComponent;
import net.tnemc.item.component.impl.BannerPatternsComponent;
import net.tnemc.item.component.impl.BaseColorComponent;
import net.tnemc.item.component.impl.BlocksAttacksComponent;
import net.tnemc.item.component.impl.BreakSoundComponent;
import net.tnemc.item.component.impl.BucketEntityDataComponent;
import net.tnemc.item.component.impl.BundleComponent;
import net.tnemc.item.component.impl.CanBreakComponent;
import net.tnemc.item.component.impl.CanPlaceOnComponent;
import net.tnemc.item.component.impl.ConsumableComponent;
import net.tnemc.item.component.impl.ContainerComponent;
import net.tnemc.item.component.impl.CustomNameComponent;
import net.tnemc.item.component.impl.DamageComponent;
import net.tnemc.item.component.impl.DamageResistantComponent;
import net.tnemc.item.component.impl.DeathProtectionComponent;
import net.tnemc.item.component.impl.DyedColorComponent;
import net.tnemc.item.component.impl.EnchantableComponent;
import net.tnemc.item.component.impl.EnchantmentGlintOverrideComponent;
import net.tnemc.item.component.impl.EnchantmentsComponent;
import net.tnemc.item.component.impl.EntityVariantComponent;
import net.tnemc.item.component.impl.EquipComponent;
import net.tnemc.item.component.impl.FireworkExplosionComponent;
import net.tnemc.item.component.impl.FireworksComponent;
import net.tnemc.item.component.impl.FoodComponent;
import net.tnemc.item.component.impl.GliderComponent;
import net.tnemc.item.component.impl.HideAdditionalTooltipComponent;
import net.tnemc.item.component.impl.HideTooltipComponent;
import net.tnemc.item.component.impl.InstrumentComponent;
import net.tnemc.item.component.impl.IntangibleProjectileComponent;
import net.tnemc.item.component.impl.ItemModelComponent;
import net.tnemc.item.component.impl.ItemNameComponent;
import net.tnemc.item.component.impl.JukeBoxComponent;
import net.tnemc.item.component.impl.LodestoneTrackerComponent;
import net.tnemc.item.component.impl.LoreComponent;
import net.tnemc.item.component.impl.MapColorComponent;
import net.tnemc.item.component.impl.MapIDComponent;
import net.tnemc.item.component.impl.MaxDamageComponent;
import net.tnemc.item.component.impl.MaxStackSizeComponent;
import net.tnemc.item.component.impl.ModelDataComponent;
import net.tnemc.item.component.impl.ModelDataOldComponent;
import net.tnemc.item.component.impl.NoteBlockSoundComponent;
import net.tnemc.item.component.impl.OminousBottleAmplifierComponent;
import net.tnemc.item.component.impl.PotDecorationsComponent;
import net.tnemc.item.component.impl.PotionContentsComponent;
import net.tnemc.item.component.impl.PotionDurationScaleComponent;
import net.tnemc.item.component.impl.ProvidesBannerPatternsComponent;
import net.tnemc.item.component.impl.ProvidesTrimMaterialComponent;
import net.tnemc.item.component.impl.RarityComponent;
import net.tnemc.item.component.impl.RecipesComponent;
import net.tnemc.item.component.impl.RepairCostComponent;
import net.tnemc.item.component.impl.RepairableComponent;
import net.tnemc.item.component.impl.StoredEnchantmentsComponent;
import net.tnemc.item.component.impl.SuspiciousStewEffectsComponent;
import net.tnemc.item.component.impl.ToolComponent;
import net.tnemc.item.component.impl.TooltipDisplayComponent;
import net.tnemc.item.component.impl.TooltipStyleComponent;
import net.tnemc.item.component.impl.TrimComponent;
import net.tnemc.item.component.impl.UnbreakableComponent;
import net.tnemc.item.component.impl.UseCooldownComponent;
import net.tnemc.item.component.impl.WeaponComponent;
import net.tnemc.item.component.impl.WritableBookContentComponent;
import net.tnemc.item.component.impl.WrittenBookContentComponent;
import net.tnemc.item.paper.platform.PaperItemPlatform;
import net.tnemc.item.paper.platform.impl.modern.PaperBundleComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperContainerComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperCustomNameComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperDamageComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperDyedColorComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperEnchantmentsComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperItemModelComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperItemNameComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperLoreComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperModelDataComponent;
import net.tnemc.item.paper.platform.impl.modern.PaperProfileComponent;
import net.tnemc.item.paper.platform.impl.old.PaperOldModelDataLegacyComponent;
import net.tnemc.item.persistent.PersistentDataHolder;
import net.tnemc.item.providers.ItemProvider;
import net.tnemc.item.providers.SkullProfile;
import org.bukkit.inventory.ItemFlag;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta;
import org.json.simple.JSONObject;
import org.json.simple.parser.ParseException;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * PaperItemStack
 *
 * @author creatorfromhell
 * @since 0.1.7.5
 */
public class PaperItemStack implements AbstractItemStack<ItemStack> {

  private final Map<String, SerialComponent<AbstractItemStack<ItemStack>, ItemStack>> components = new HashMap<>();

  private final List<String> flags = new ArrayList<>();

  private final PersistentDataHolder holder = new PersistentDataHolder();

  private int slot = 0;
  private String material;
  private int amount = 1;
  private boolean debug = false;

  //item providers
  private String itemProvider = PaperItemPlatform.instance().defaultProviderIdentifier();
  private String providerItemID = material;

  //our locale stack
  private boolean dirty = false;
  private ItemStack localeStack;

  /**
   * Creates a new item stack with the specified material and amount.
   *
   * @param material The material of the item.
   * @param amount   The number of items in the stack.
   *
   * @return A new item stack instance.
   */
  @Override
  public PaperItemStack of(final String material, final int amount) {

    this.material = material;
    this.amount = amount;
    this.dirty = true;
    return this;
  }

  /**
   * Creates a new item stack from a locale-specific object.
   *
   * @param locale The locale-specific representation.
   *
   * @return A new item stack instance.
   */
  @Override
  public PaperItemStack of(final ItemStack locale) {

    this.localeStack = locale;
    this.material = locale.getType().getKey().toString();

    this.amount = locale.getAmount();
    final ItemMeta meta = locale.getItemMeta();
    if(meta != null) {
      for(final ItemFlag flag : meta.getItemFlags()) {

        this.flags.add(flag.name());
      }
    }

    return PaperItemPlatform.instance().serializer(this.localeStack, this);
  }

  /**
   * Creates a new item stack from a JSON representation.
   *
   * @param json The JSON object containing item stack data.
   *
   * @return A new item stack instance.
   *
   * @throws ParseException If the JSON structure is invalid.
   */
  @Override
  public PaperItemStack of(final JSONObject json) throws ParseException {


    return this;
  }

  /**
   * Sets the item flags.
   *
   * @param flags A list of flags to apply to the item.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack flags(final List<String> flags) {

    this.flags.addAll(flags);
    this.dirty = true;
    return this;
  }

  /**
   * Sets the lore (descriptive text) of the item stack.
   *
   * @param lore A list of components representing the lore.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack loreComponent(final List<Component> lore) {

    applyComponent(new PaperLoreComponent(lore));
    return this;
  }

  /**
   * Adds an enchantment to the item stack.
   *
   * @param enchantment The enchantment name.
   * @param level       The level of the enchantment.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack enchant(final String enchantment, final int level) {

    applyComponent(new PaperEnchantmentsComponent(new HashMap<>(){{
      put(enchantment, level);
    }}));
    return this;
  }

  /**
   * Adds multiple enchantments to the item stack.
   *
   * @param enchantments A map of enchantment names and levels.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack enchant(final Map<String, Integer> enchantments) {

    applyComponent(new PaperEnchantmentsComponent(enchantments));
    return this;
  }

  /**
   * Adds enchantments to the item stack by name.
   *
   * @param enchantments A list of enchantment names.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack enchant(final List<String> enchantments) {

    final Map<String, Integer> enchants = new HashMap<>();
    for(final String enchantment : enchantments) {
      enchants.put(enchantment, 1);
    }
    applyComponent(new PaperEnchantmentsComponent(enchants));
    return this;
  }

  /**
   * Returns the material of the item stack.
   *
   * @return The material of the item stack.
   */
  @Override
  public String material() {

    return material;
  }

  /**
   * Sets the material of the item stack.
   *
   * @param material The material name.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack material(final String material) {

    this.material = material;
    this.dirty = true;
    return this;
  }

  /**
   * The quantity of the item stack.
   *
   * @return the quantity of the item stack.
   */
  @Override
  public int amount() {

    return amount;
  }

  /**
   * Sets the quantity of the item stack.
   *
   * @param amount The number of items in the stack.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack amount(final int amount) {

    this.amount = amount;
    this.dirty = true;
    return this;
  }

  /**
   * Represents the inventory slot of the item stack.
   *
   * @return the inventory slot of the item stack.
   */
  @Override
  public int slot() {

    return slot;
  }

  /**
   * Sets the inventory slot of the item stack.
   *
   * @param slot The slot index.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack slot(final int slot) {

    this.slot = slot;
    this.dirty = true;
    return this;
  }

  /**
   * Enables or disables debug mode for the item stack.
   *
   * @param debug True to enable, false to disable.
   *
   * @return The updated item stack instance.
   */
  @Override
  public PaperItemStack debug(final boolean debug) {

    this.debug = debug;
    return this;
  }

  public ItemStack cacheLocale() {

    return this.localeStack;
  }

  public void updateCache(final ItemStack localeStack) {

    this.localeStack = localeStack;
  }

  /**
   * Replaces the persistent data holder for the item stack.
   *
   * @param newHolder  The new persistent data holder.
   * @param replaceOld True to replace existing data, false to merge.
   *
   * @return The updated item stack instance.
   *
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack applyPersistentHolder(final PersistentDataHolder newHolder, final boolean replaceOld) {

    if(replaceOld) {
      this.holder.getData().clear();
    }

    this.holder.getData().putAll(newHolder.getData());
    this.dirty = true;
    return this;
  }

  /**
   * Retrieves the item flags.
   *
   * @return A list of flags applied to the item.
   */
  @Override
  public List<String> flags() {

    return this.flags;
  }

  /**
   * Retrieves the components applied to the item stack.
   *
   * @return A map of component types and their serialized representations.
   *
   * @since 0.2.0.0
   */
  @Override
  public Map<String, SerialComponent<AbstractItemStack<ItemStack>, ItemStack>> components() {

    return components;
  }

  /**
   * Retrieves the persistent data holder for the item stack.
   *
   * @return The persistent data holder.
   *
   * @since 0.2.0.0
   */
  @Override
  public PersistentDataHolder persistentHolder() {

    return holder;
  }

  /**
   * Resets the dirty flag, indicating that the object's state has been synchronized with the
   * database.
   */
  @Override
  public void resetDirty() {
    this.dirty = false;
  }

  /**
   * Marks the item stack as dirty, indicating changes have been made.
   */
  @Override
  public void markDirty() {

    this.dirty = true;
  }

  /**
   * Checks whether the object is dirty or has unsaved changes.
   *
   * @return true if the object is dirty, false otherwise
   */
  @Override
  public boolean isDirty() {

    return this.dirty;
  }

  /**
   * This method returns a String representing the item provider.
   *
   * @return the item provider as a String
   *
   * @see ItemProvider
   */
  @Override
  public String itemProvider() {

    return this.itemProvider;
  }

  /**
   * Sets the item provider to be used for retrieving items.
   *
   * @param itemProvider the string representing the item provider to be set
   */
  @Override
  public PaperItemStack setItemProvider(final String itemProvider) {
    this.itemProvider = itemProvider;
    this.dirty = true;
    return this;
  }

  /**
   * Retrieves the provider item ID associated with the current object.
   *
   * @return The provider item ID of the object.
   */
  @Override
  public String providerItemID() {

    return this.providerItemID;
  }

  /**
   * Sets the provider's item ID for the current item.
   *
   * @param providerItemID the unique ID assigned by the provider for the item
   */
  @Override
  public PaperItemStack setProviderItemID(final String providerItemID) {

    this.providerItemID = providerItemID;
    this.dirty = true;
    return this;
  }

  /**
   * This method is used to return an ItemProvider object.
   *
   * @return ItemProvider object representing the item provider.
   */
  @Override
  public ItemProvider<ItemStack> provider() {

    return PaperItemPlatform.instance().provider(itemProvider);
  }

  /**
   * Converts the object to a JSONObject representation.
   *
   * @return A JSONObject representing the object data.
   */
  @Override
  public JSONObject toJSON() {

    return null;
  }

  /**
   * Updates the attribute modifiers of the item stack.
   *
   * @param modifiers     a list of attribute modifiers
   * @param showInTooltip whether to display the modifiers in the tooltip
   *
   * @return the updated PaperItemStack instance
   *
   * @see AttributeModifiersComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack attributeModifiers(final List<AttributeModifier> modifiers, final boolean showInTooltip) {

    return this;
  }

  /**
   * Updates the banner patterns of the item stack.
   *
   * @param patterns a list of pattern data
   *
   * @return the updated PaperItemStack instance
   *
   * @see BannerPatternsComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack bannerPatterns(final List<PatternData> patterns) {

    return this;
  }

  /**
   * Updates the base color of the item stack.
   *
   * @param color the new base color
   *
   * @return the updated PaperItemStack instance
   *
   * @see BaseColorComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack baseColor(final String color) {

    return this;
  }

  /**
   * Blocks attacks with the specified damage type using this item.
   *
   * @param damage the type of damage to block attacks from
   *
   * @return an AbstractItemStack object representing the item after blocking attacks
   *
   * @see BlocksAttacksComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> blocksAttacks(final ItemDamage damage) {

    return this;
  }

  /**
   * Set the break sound for this item stack.
   *
   * @param sound the sound to be played when the item is broken
   *
   * @return the updated item stack object
   *
   * @see BreakSoundComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> breakSound(final String sound) {

    return this;
  }

  /**
   * Updates the bucket entity data of the item stack.
   *
   * @param noAI             whether the entity has AI disabled
   * @param silent           whether the entity is silent
   * @param noGravity        whether the entity is affected by gravity
   * @param glowing          whether the entity is glowing
   * @param invulnerable     whether the entity is invulnerable
   * @param health           the health of the entity
   * @param age              the age of the entity
   * @param variant          the variant of the entity
   * @param huntingCooldown  the hunting cooldown of the entity
   * @param bucketVariantTag the variant tag of the bucket
   * @param type             the type of the entity
   *
   * @return the updated PaperItemStack instance
   *
   * @see BucketEntityDataComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack bucketEntityData(final boolean noAI, final boolean silent, final boolean noGravity, final boolean glowing, final boolean invulnerable, final float health, final int age, final int variant, final long huntingCooldown, final int bucketVariantTag, final String type) {

    return this;
  }

  /**
   * Bundles a collection of {@link AbstractItemStack} instances into a single collection.
   *
   * @param items A {@link Map} containing integer keys and {@link AbstractItemStack} values to be
   *              bundled.
   *
   * @return An {@link AbstractItemStack} instance that represents the bundled items.
   *
   * @see BundleComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack bundle(final Map<Integer, AbstractItemStack<ItemStack>> items) {

    applyComponent(new PaperBundleComponent(items));
    return this;
  }

  /**
   * Updates the blocks that the item stack can break.
   *
   * @param predicates a list of block predicates
   *
   * @return the updated PaperItemStack instance
   *
   * @see CanBreakComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack canBreak(final List<BlockPredicate> predicates) {

    return this;
  }

  /**
   * Updates the blocks that the item stack can be placed on.
   *
   * @param predicates a list of block predicates
   *
   * @return the updated PaperItemStack instance
   *
   * @see CanPlaceOnComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack canPlaceOn(final List<BlockPredicate> predicates) {

    return this;
  }

  /**
   * Updates the consumable properties of the item stack.
   *
   * @param consumeSeconds      the time it takes to consume the item
   * @param animation           the animation to display when consuming
   * @param sound               the sound to play when consuming
   * @param hasConsumeParticles whether to show consume particles
   * @param effects             a list of effects applied on consumption
   *
   * @return the updated PaperItemStack instance
   *
   * @see ConsumableComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack consumable(final float consumeSeconds, final String animation, final String sound, final boolean hasConsumeParticles, final List<ComponentEffect> effects) {

    return this;
  }

  /**
   * Constructs a container with the given map of items.
   *
   * @param items a map of items where the key is the position of the item in the container and the
   *              value is the item
   *
   * @return an AbstractItemStack container with the specified items
   *
   * @see ContainerComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack container(final Map<Integer, AbstractItemStack<ItemStack>> items) {

    applyComponent(new PaperContainerComponent(items));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the custom name of the item stack.
   *
   * @param customName the custom name to set
   *
   * @return the updated PaperItemStack instance
   *
   * @see CustomNameComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack customName(final Component customName) {

    applyComponent(new PaperCustomNameComponent(customName));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the damage of the item stack.
   *
   * @param damage the damage value to set
   *
   * @return the updated PaperItemStack instance
   *
   * @see DamageComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack damage(final int damage) {

    applyComponent(new PaperDamageComponent(damage));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the damage-resistant types of the item stack.
   *
   * @param types a list of damage-resistant types
   *
   * @return the updated PaperItemStack instance
   *
   * @see DamageResistantComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack damageResistant(final List<String> types) {

    return this;
  }

  /**
   * Updates the death protection effects of the item stack.
   *
   * @param deathEffects a list of death protection effects
   *
   * @return the updated PaperItemStack instance
   *
   * @see DeathProtectionComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack deathProtection(final List<ComponentEffect> deathEffects) {

    return this;
  }

  /**
   * Updates the dyed color of the item stack.
   *
   * @param rgb the RGB color value to set
   *
   * @return the updated PaperItemStack instance
   *
   * @see DyedColorComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack dyedColor(final int rgb) {

    applyComponent(new PaperDyedColorComponent(rgb));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the enchantability of the item stack.
   *
   * @param value the enchantability value to set
   *
   * @return the updated PaperItemStack instance
   *
   * @see EnchantableComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack enchantable(final int value) {

    return this;
  }

  /**
   * Updates the enchantment glint override of the item stack.
   *
   * @param glintOverride whether the enchantment glint should be overridden
   *
   * @return the updated PaperItemStack instance
   *
   * @see EnchantmentGlintOverrideComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack enchantmentGlintOverride(final boolean glintOverride) {

    return this;
  }

  /**
   * Updates the enchantments of the item stack.
   *
   * @param levels a map of enchantments and their levels
   *
   * @return the updated PaperItemStack instance
   *
   * @see EnchantmentsComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack enchantments(final Map<String, Integer> levels) {

    applyComponent(new PaperEnchantmentsComponent(levels));
    this.dirty = true;
    return this;
  }

  /**
   * Generates an AbstractItemStack based on the given entity and variant.
   *
   * @param entity  the entity name to create the stack for
   * @param variant the variant of the entity
   *
   * @return an AbstractItemStack representing the entity with the specified variant
   *
   * @see EntityVariantComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> entityVariant(final String entity, final String variant) {

    return this;
  }

  /**
   * Equips an item with specified parameters.
   *
   * @param cameraKey       the key identifying the camera
   * @param equipSound      the key identifying the equip sound
   * @param modelKey        the key identifying the model
   * @param slot            the slot in which the item should be equipped
   * @param damageOnHurt    flag indicating if damage should be taken on hurt
   * @param dispensable     flag indicating if the item is dispensable
   * @param swappable       flag indicating if the item is swappable
   * @param equipOnInteract flag indicating if the item should be equipped on interact
   * @param entities        a list of entities to be equipped
   *
   * @return an PaperItemStack object representing the equipped item
   *
   * @see EquipComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack equip(final String cameraKey, final String equipSound, final String modelKey, final EquipSlot slot, final boolean damageOnHurt, final boolean dispensable, final boolean swappable, final boolean equipOnInteract, final List<String> entities) {

    return this;
  }

  /**
   * Updates the firework explosion properties of the item stack.
   *
   * @param explosion the explosion data to set
   *
   * @return the updated PaperItemStack instance
   *
   * @see FireworkExplosionComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack fireworkExplosion(final ExplosionData explosion) {

    return this;
  }

  /**
   * Updates the fireworks properties of the item stack.
   *
   * @param flightDuration the flight duration of the fireworks
   * @param explosions     a list of explosion data
   *
   * @return the updated PaperItemStack instance
   *
   * @see FireworksComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack fireworks(final byte flightDuration, final List<ExplosionData> explosions) {

    return this;
  }

  /**
   * Updates the food properties of the item stack.
   *
   * @param noHunger   whether the item causes no hunger
   * @param saturation the saturation value
   * @param nutrition  the nutrition value
   *
   * @return the updated PaperItemStack instance
   *
   * @see FoodComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack food(final boolean noHunger, final float saturation, final int nutrition) {

    return this;
  }

  /**
   * Updates the item stack to enable glider functionality.
   *
   * @return the updated PaperItemStack instance
   *
   * @see GliderComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack gliderTag() {

    return this;
  }

  /**
   * Updates the item stack to hide additional tooltip.
   *
   * @return the updated PaperItemStack instance
   *
   * @see HideAdditionalTooltipComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack hideAdditionalTooltipTag() {

    return this;
  }

  /**
   * Updates the item stack to hide its tooltip.
   *
   * @return the updated PaperItemStack instance
   *
   * @see HideTooltipComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack hideTooltipTag() {

    return this;
  }

  /**
   * Updates the instrument properties of the item stack.
   *
   * @param soundEvent  the sound event identifier
   * @param useDuration the duration of the sound in ticks
   * @param range       the range of the sound
   *
   * @return the updated PaperItemStack instance
   *
   * @see InstrumentComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack instrument(final String soundEvent, final int useDuration, final int range) {

    return this;
  }

  /**
   * Updates the item stack as an intangible projectile.
   *
   * @return the updated PaperItemStack instance
   *
   * @see IntangibleProjectileComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack intangibleProjectileTag() {

    return this;
  }

  /**
   * Updates the model properties of the item stack.
   *
   * @param model the model identifier
   *
   * @return the updated PaperItemStack instance
   *
   * @see ItemModelComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack itemModel(final String model) {

    applyComponent(new PaperItemModelComponent(model));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the name of the item stack.
   *
   * @param itemName the name of the item
   *
   * @return the updated PaperItemStack instance
   *
   * @see ItemNameComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack itemName(final Component itemName) {

    applyComponent(new PaperItemNameComponent(itemName));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the jukebox properties of the item stack.
   *
   * @param song          the song identifier
   * @param showInTooltip whether to display the song in the tooltip
   *
   * @return the updated PaperItemStack instance
   *
   * @see JukeBoxComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack jukebox(final String song, final boolean showInTooltip) {

    return this;
  }

  /**
   * Updates the lodestone tracker properties of the item stack.
   *
   * @param target    the target identifier
   * @param pos       the position array
   * @param dimension the dimension identifier
   * @param tracked   whether the lodestone is tracked
   *
   * @return the updated PaperItemStack instance
   *
   * @see LodestoneTrackerComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack lodestoneTracker(final String target, final int[] pos, final String dimension, final boolean tracked) {

    return this;
  }

  /**
   * Updates the lore of the item stack.
   *
   * @param lore a list of lore strings
   *
   * @return the updated PaperItemStack instance
   *
   * @see LoreComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack lore(final List<Component> lore) {

    applyComponent(new PaperLoreComponent(lore));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the map color of the item stack.
   *
   * @param mapColor the map color value
   *
   * @return the updated PaperItemStack instance
   *
   * @see MapColorComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack mapColor(final int mapColor) {

    return this;
  }

  /**
   * Updates the map ID of the item stack.
   *
   * @param mapId the map ID value
   *
   * @return the updated PaperItemStack instance
   *
   * @see MapIDComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack mapId(final int mapId) {

    return this;
  }

  /**
   * Updates the maximum damage of the item stack.
   *
   * @param maxDamage the maximum damage value
   *
   * @return the updated PaperItemStack instance
   *
   * @see MaxDamageComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack maxDamage(final int maxDamage) {

    return this;
  }

  /**
   * Updates the maximum stack size of the item stack.
   *
   * @param maxStackSize the maximum stack size value
   *
   * @return the updated PaperItemStack instance
   *
   * @see MaxStackSizeComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack maxStackSize(final int maxStackSize) {

    return this;
  }

  /**
   * Updates the model data of the item stack.
   *
   * @param colours a list of color strings
   * @param floats  a list of float values
   * @param flags   a list of boolean flags
   * @param strings a list of string identifiers
   *
   * @return the updated PaperItemStack instance
   *
   * @see ModelDataComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack modelData(final List<String> colours, final List<Float> floats, final List<Boolean> flags, final List<String> strings) {

    applyComponent(new PaperModelDataComponent(colours, floats, flags, strings));
    this.dirty = true;
    return this;
  }

  /**
   * Retrieves the model data for a custom item stack.
   *
   * @param customModelData the custom model data to retrieve
   *
   * @return an AbstractItemStack with the specified custom model data
   *
   * @see ModelDataOldComponent
   * @since 0.2.0.0
   * @deprecated Since MC 1.21.3 Use {@link ItemModelComponent} and {@link ModelDataComponent}.
   */
  @Override
  public AbstractItemStack<ItemStack> modelDataOld(final int customModelData) {

    applyComponent(new PaperOldModelDataLegacyComponent(customModelData));
    this.dirty = true;
    return this;
  }

  /**
   * Updates the note block sound of the item stack.
   *
   * @param soundId the identifier of the sound
   *
   * @return the updated PaperItemStack instance
   *
   * @see NoteBlockSoundComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack noteBlockSound(final String soundId) {

    return this;
  }

  /**
   * Updates the ominous bottle amplifier of the item stack.
   *
   * @param amplifier the amplifier value
   *
   * @return the updated PaperItemStack instance
   *
   * @see OminousBottleAmplifierComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack ominousBottleAmplifier(final int amplifier) {

    return this;
  }

  /**
   * Updates the pot decorations of the item stack.
   *
   * @param decorations a list of decorations
   *
   * @return the updated PaperItemStack instance
   *
   * @see PotDecorationsComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack potDecorations(final List<String> decorations) {

    return this;
  }

  /**
   * Updates the potion contents of the item stack.
   *
   * @param potionId    the ID of the potion
   * @param customColor the custom color of the potion
   * @param customName  the custom name of the potion
   * @param effects     a list of effect instances
   *
   * @return the updated PaperItemStack instance
   *
   * @see PotionContentsComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack potionContents(final String potionId, final int customColor, final String customName, final List<EffectInstance> effects) {

    return this;
  }

  /**
   * Sets the duration of a potion effect for the item stack. Since MC Snapshot 25w02a.
   *
   * @param potionDuration the duration of the potion effect in seconds
   *
   * @return the modified PaperItemStack object with the updated potion duration
   *
   * @see PotionDurationScaleComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack potionDuration(final float potionDuration) {

    return this;
  }

  /**
   * Profiles the given SkullProfile to the PaperItemStack object.
   *
   * @param profile the SkullProfile to be assigned
   *
   * @return an PaperItemStack object with the provided profile
   */
  @Override
  public PaperItemStack profile(final SkullProfile profile) {

    applyComponent(new PaperProfileComponent(profile));
    this.dirty = true;
    return this;
  }

  /**
   * Retrieve an AbstractItemStack object that provides a specific pattern identified by the
   * patternTag.
   *
   * @param patternTag The unique identifier of the pattern to be provided.
   *
   * @return An AbstractItemStack object that provides the specified pattern.
   *
   * @see ProvidesBannerPatternsComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> providesPattern(final String patternTag) {

    return this;
  }

  /**
   * Applies the specified trim material
   *
   * @param material the trim material
   *
   * @return an AbstractItemStack object representing the trimmed material
   *
   * @see ProvidesTrimMaterialComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> providesTrim(final String material) {

    return this;
  }

  /**
   * Updates the rarity of the item stack.
   *
   * @param rarity the rarity value
   *
   * @return the updated PaperItemStack instance
   *
   * @see RarityComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack rarity(final String rarity) {

    return this;
  }

  /**
   * Updates the recipes of the item stack.
   *
   * @param recipes a list of recipe identifiers
   *
   * @return the updated PaperItemStack instance
   *
   * @see RecipesComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack recipes(final List<String> recipes) {

    return this;
  }

  /**
   * Updates the repairable items of the item stack.
   *
   * @param repairItems a list of repair item identifiers
   *
   * @return the updated PaperItemStack instance
   *
   * @see RepairableComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack repairable(final List<String> repairItems) {

    return this;
  }

  /**
   * Updates the repair cost of the item stack.
   *
   * @param repairCost the repair cost value
   *
   * @return the updated PaperItemStack instance
   *
   * @see RepairCostComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack repairCost(final int repairCost) {

    return this;
  }

  /**
   * Updates the stored enchantments of the item stack.
   *
   * @param enchantments a map of enchantment names to their levels
   *
   * @return the updated PaperItemStack instance
   *
   * @see StoredEnchantmentsComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack storedEnchantments(final Map<String, Integer> enchantments) {

    return this;
  }

  /**
   * Applies the given effects to the suspicious stew item.
   *
   * @param effects a list of EffectInstance objects representing the effects to be applied to the
   *                suspicious stew
   *
   * @return an AbstractItemStack representing the suspicious stew with the applied effects
   *
   * @see SuspiciousStewEffectsComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> suspiciousStewEffects(final List<EffectInstance> effects) {

    return this;
  }

  /**
   * Applies the given effects to a suspicious stew item.
   *
   * @param effects an array of EffectInstance objects representing the effects to apply to the
   *                suspicious stew
   *
   * @return an AbstractItemStack representing the suspicious stew item with the applied effects
   *
   * @see SuspiciousStewEffectsComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> suspiciousStewEffects(final EffectInstance... effects) {

    return this;
  }

  /**
   * Constructs a new tool item with the specified characteristics.
   *
   * @param defaultSpeed             the default speed of the tool
   * @param blockDamage              the damage inflicted by the tool to blocks
   * @param canDestroyBlocksCreative if the tool can destroy blocks in creative mode
   * @param rules                    a list of rules that define the behavior of the tool
   *
   * @return an PaperItemStack instance representing the created tool
   *
   * @see ToolComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack tool(final float defaultSpeed, final int blockDamage, final boolean canDestroyBlocksCreative, final List<ToolRule> rules) {

    return this;
  }

  /**
   * Displays tooltip for the item stack with an option to hide certain components.
   *
   * @param hideTooltip      Flag to hide the tooltip
   * @param hiddenComponents Array of components to hide in the tooltip
   *
   * @return An AbstractItemStack object with the tooltip displayed
   *
   * @see TooltipDisplayComponent
   * @since 0.2.0.0
   */
  @Override
  public AbstractItemStack<ItemStack> tooltipDisplay(final boolean hideTooltip, final String... hiddenComponents) {

    return this;
  }

  /**
   * Updates the tooltip style of the item stack.
   *
   * @param style the style to apply to the tooltip
   *
   * @return the updated PaperItemStack instance
   *
   * @see TooltipStyleComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack tooltipStyle(final String style) {

    return this;
  }

  /**
   * Updates the trim properties of the item stack.
   *
   * @param pattern       the trim pattern
   * @param material      the trim material
   * @param showInTooltip whether to display the trim in the tooltip
   *
   * @return the updated PaperItemStack instance
   *
   * @see TrimComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack trim(final String pattern, final String material, final boolean showInTooltip) {

    return this;
  }

  /**
   * Updates the unbreakable property of the item stack.
   *
   * @param showInTooltip whether to display the unbreakable property in the tooltip
   *
   * @return the updated PaperItemStack instance
   *
   * @see UnbreakableComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack unbreakable(final boolean showInTooltip) {

    return this;
  }

  /**
   * Updates the use cooldown properties of the item stack.
   *
   * @param cooldownGroup the cooldown group identifier
   * @param seconds       the cooldown duration in seconds
   *
   * @return the updated PaperItemStack instance
   *
   * @see UseCooldownComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack useCooldown(final String cooldownGroup, final float seconds) {

    return this;
  }

  /**
   * Represents a weapon item that can be used for combat. Since MC Snapshot 25w02a.
   *
   * @param damagePerAttack    The amount of damage this weapon inflicts per attack
   * @param canDisableBlocking Whether this weapon can disable blocking when used
   *
   * @see WeaponComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack weapon(final int damagePerAttack, final boolean canDisableBlocking) {

    return this;
  }

  /**
   * Updates the writable book content of the item stack.
   *
   * @param pages the pages to include in the writable book
   *
   * @return the updated PaperItemStack instance
   *
   * @see WritableBookContentComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack writableBookContent(final List<String> pages) {

    return this;
  }

  /**
   * Updates the written book content of the item stack.
   *
   * @param title      the title of the book
   * @param author     the author of the book
   * @param generation the generation of the book
   * @param resolved   whether the book is resolved
   * @param pages      the pages to include in the book
   *
   * @return the updated PaperItemStack instance
   *
   * @see WrittenBookContentComponent
   * @since 0.2.0.0
   */
  @Override
  public PaperItemStack writtenBookContent(final String title, final String author, final int generation, final boolean resolved, final List<String> pages) {

    return this;
  }
}