0.0.1

resources/[core]/es_extended/shared/modules/math.lua

@@ -0,0 +1,50 @@
+ESX.Math = {}
+
+---@param value number
+---@param numDecimalPlaces? number
+---@return number
+function ESX.Math.Round(value, numDecimalPlaces)
+    if numDecimalPlaces then
+        local power = 10 ^ numDecimalPlaces
+        return math.floor((value * power) + 0.5) / power
+    else
+        return math.floor(value + 0.5)
+    end
+end
+
+-- credit http://richard.warburton.it
+---@param value number
+---@return string
+function ESX.Math.GroupDigits(value)
+    local left, num, right = string.match(value, "^([^%d]*%d)(%d*)(.-)$")
+
+    return left .. (num:reverse():gsub("(%d%d%d)", "%1" .. TranslateCap("locale_digit_grouping_symbol")):reverse()) .. right
+end
+
+---@param value string | number
+---@return string | nil
+function ESX.Math.Trim(value)
+    value = tostring(value)
+    return (string.gsub(value, "^%s*(.-)%s*$", "%1"))
+end
+
+---@param minRange number
+---@param maxRange number
+---@return number
+function ESX.Math.Random(minRange, maxRange)
+    math.randomseed(GetGameTimer())
+    return math.random(minRange or 1, maxRange or 10)
+end
+
+---@param origin vector
+---@param target vector
+---@return number
+function ESX.Math.GetHeadingFromCoords(origin, target)
+	local dx = origin.x - target.x
+    local dy = origin.y - target.y
+
+    local heading = math.deg(math.atan(dy, dx)) + 90
+
+    return (heading + 360) % 360
+end
+

resources/[core]/es_extended/shared/modules/table.lua

@@ -0,0 +1,241 @@
+ESX.Table = {}
+
+-- nil proof alternative to #table
+---@param t table
+---@return number
+function ESX.Table.SizeOf(t)
+    local count = 0
+
+    for _, _ in pairs(t) do
+        count = count + 1
+    end
+
+    return count
+end
+
+---@param t table
+---@return table
+function ESX.Table.Set(t)
+    local set = {}
+    for _, v in ipairs(t) do
+        set[v] = true
+    end
+    return set
+end
+
+---@param t table
+---@param value any
+---@return number
+function ESX.Table.IndexOf(t, value)
+    for i = 1, #t, 1 do
+        if t[i] == value then
+            return i
+        end
+    end
+
+    return -1
+end
+
+---@param t table
+---@param value any
+---@return number
+function ESX.Table.LastIndexOf(t, value)
+    for i = #t, 1, -1 do
+        if t[i] == value then
+            return i
+        end
+    end
+
+    return -1
+end
+
+---@param t table
+---@param cb function
+---@return any
+function ESX.Table.Find(t, cb)
+    for i = 1, #t, 1 do
+        if cb(t[i]) then
+            return t[i]
+        end
+    end
+
+    return nil
+end
+
+---@param t table
+---@param cb function
+---@return number
+function ESX.Table.FindIndex(t, cb)
+    for i = 1, #t, 1 do
+        if cb(t[i]) then
+            return i
+        end
+    end
+
+    return -1
+end
+
+---@param t table
+---@param cb function
+---@return table
+function ESX.Table.Filter(t, cb)
+    local newTable = {}
+
+    for i = 1, #t, 1 do
+        if cb(t[i]) then
+            newTable[#newTable + 1] = t[i]
+        end
+    end
+
+    return newTable
+end
+
+---@param t table
+---@param cb function
+---@return table
+function ESX.Table.Map(t, cb)
+    local newTable = {}
+
+    for i = 1, #t, 1 do
+        newTable[i] = cb(t[i], i)
+    end
+
+    return newTable
+end
+
+---@param t table
+---@return table
+function ESX.Table.Reverse(t)
+    local newTable = {}
+
+    for i = #t, 1, -1 do
+        table.insert(newTable, t[i])
+    end
+
+    return newTable
+end
+
+---@param t table
+---@return table
+function ESX.Table.Clone(t)
+    if type(t) ~= "table" then
+        return t
+    end
+
+    local meta = getmetatable(t)
+    local target = {}
+
+    for k, v in pairs(t) do
+        if type(v) == "table" then
+            target[k] = ESX.Table.Clone(v)
+        else
+            target[k] = v
+        end
+    end
+
+    setmetatable(target, meta)
+
+    return target
+end
+
+---@param t1 table
+---@param t2 table
+---@return table
+function ESX.Table.Concat(t1, t2)
+    local t3 = ESX.Table.Clone(t1)
+
+    for i = 1, #t2, 1 do
+        table.insert(t3, t2[i])
+    end
+
+    return t3
+end
+
+---@param t table
+---@param sep string
+---@return string
+function ESX.Table.Join(t, sep)
+    local str = ""
+
+    for i = 1, #t, 1 do
+        if i > 1 then
+            str = str .. (sep or ",")
+        end
+
+        str = str .. t[i]
+    end
+
+    return str
+end
+
+-- Credits: https://github.com/JonasDev99/qb-garages/blob/b0335d67cb72a6b9ac60f62a87fb3946f5c2f33d/server/main.lua#L5
+---@param tab table
+---@param val any
+---@return boolean
+function ESX.Table.TableContains(tab, val)
+    if type(val) == "table" then
+        for _, value in pairs(tab) do
+            if ESX.Table.TableContains(val, value) then
+                return true
+            end
+        end
+        return false
+    else
+        for _, value in pairs(tab) do
+            if value == val then
+                return true
+            end
+        end
+    end
+    return false
+end
+
+-- Credit: https://stackoverflow.com/a/15706820
+-- Description: sort function for pairs
+---@param t table
+---@param order function
+---@return function
+function ESX.Table.Sort(t, order)
+    -- collect the keys
+    local keys = {}
+
+    for k, _ in pairs(t) do
+        keys[#keys + 1] = k
+    end
+
+    -- if order function given, sort by it by passing the table and keys a, b,
+    -- otherwise just sort the keys
+    if order then
+        table.sort(keys, function(a, b)
+            return order(t, a, b)
+        end)
+    else
+        table.sort(keys)
+    end
+
+    -- return the iterator function
+    local i = 0
+
+    return function()
+        i = i + 1
+        if keys[i] then
+            return keys[i], t[keys[i]]
+        end
+    end
+end
+
+---@param t table
+---@return Array
+function ESX.Table.ToArray(t)
+    local array = {}
+    for _, v in pairs(t) do
+        array[#array + 1] = v
+    end
+    return array
+end
+
+---@param t table
+---@return table
+function ESX.Table.Wipe(t)
+    return table.wipe(t)
+end

resources/[core]/es_extended/shared/modules/timeout.lua

@@ -0,0 +1,28 @@
+local TimeoutCount = 0
+local CancelledTimeouts = {}
+
+---@param msec number
+---@param cb function
+---@return number
+ESX.SetTimeout = function(msec, cb)
+    local id <const> = TimeoutCount + 1
+
+    SetTimeout(msec, function()
+        if CancelledTimeouts[id] then
+            CancelledTimeouts[id] = nil
+            return
+        end
+
+        cb()
+    end)
+
+    TimeoutCount = id
+
+    return id
+end
+
+---@param id number
+---@return nil
+ESX.ClearTimeout = function(id)
+    CancelledTimeouts[id] = true
+end