--- Get the first free slot in the player's inventory
-- @return number|nil The free slot number or nil if the inventory is full
exports.LGF_Inventory:getFirstFreeSlot()

--- Get the player's personal inventory
-- @return Item[] The player's inventory
exports.LGF_Inventory:getPlayerItems()

--- Get an item from the specified slot
-- @param slot number The slot number to retrieve the item from
-- @return Item|nil The item found, or nil if it doesn't exist
exports.LGF_Inventory:getItemFromSlot(slot)

--- Calculate the total weight of the player's inventory
-- @return number The total weight of the inventory
exports.LGF_Inventory:getInventoryWeight()

--- Retrieves the money count of a player based on the type of money.
-- @param type string Type of money ("money", "black_money", etc.)
-- @return number Returns the amount of the specified money type the player has in their inventory
local moneyCount = exports.LGF_Inventory:getMoneyCount(type)

--- Check if the player's inventory contains at least the given quantity of the specified item
-- @param itemName string The name of the item to check (case-insensitive)
-- @param quantity number The required quantity
-- @return boolean hasItem True if the item exists in at least the given quantity, false otherwise
-- @return number itemCount The actual quantity of the item found
local hasItem, itemCount =  exports.LGF_Inventory:hasItem(itemName, quantity)

--- Check if a specific slot is occupied
-- @param slot number The slot number to check
-- @return boolean True if the slot is occupied, false otherwise
exports.LGF_Inventory:isSlotOccupied(slot)

--- Close the player's inventory
exports.Inventory:closeInventory()

--- Set the state of the weapon wheel (enabled or disabled)
-- @param enabled boolean If true, the weapon wheel is enabled, otherwise it is disabled
exports.LGF_Inventory:setWheelState(enabled)

--- Disarm the currently equipped weapon
exports.LGF_Inventory:disarmWeapon()

--- Get the current state of the weapon wheel (enabled or disabled)
-- @return boolean True if the weapon wheel is enabled, false if it is disabled
exports.LGF_Inventory:getWheelState()

--- Check if the player is currently carrying a weapon
-- @return table Returns the current state of carried weapons
exports.LGF_Inventory:isCarryWeapon()

--- Check if the player's inventory is currently open
-- @return boolean True if the inventory is open, false otherwise
exports.LGF_Inventory:isInventoryOpen()

--- Retrieve the data of a weapon item from the inventory
-- @return table weaponData Returns a table containing the weapon data
-- Example structure:
-- {
--    durability: number,
--    stackable: boolean,
--    closeOnUse: boolean,
--    metadata: {
--        CurrentAmmo: number,
--        Durability: number,
--        Serial: string
--    },
--    itemRarity: string,
--    itemLabel: string,
--    itemName: string,
--    throwItem: boolean,
--    itemWeight: number,
--    itemType: string,
--    slot: number,
--    description: string,
--    typeAmmo: string,
--    quantity: number
-- }
exports.LGF_Inventory:getWeaponData()

--- Opens the shop inventory with the given shopId
-- @param shopId number The ID of the shop to open
exports.LGF_Inventory:openShop(shopId)

--- Opens the crafting inventory with the given craftingId
-- @param craftingId number The ID of the crafting menu to open
exports.LGF_Inventory:openCrafting(craftingId)

--- Opens the stash inventory with the given stashId
-- @param stashId number The ID of the stash menu to open
 exports.LGF_Inventory:openTempStash(stashId)