Merge pull request #1567 from Kenshiin13/require

feat(es_extended/imports): add require

[core]/es_extended/imports.lua

@@ -1,4 +1,5 @@
 ESX = exports["es_extended"]:getSharedObject()
+_resourceName = GetCurrentResourceName()
 
 OnPlayerData = function (key, val, last) end
 
@@ -42,3 +43,68 @@ if not IsDuplicityVersion() then -- Only register this event for the client
         end
     end
 end
+
+if not lib?.require then
+    local cachedModules = {} ---@type table<string, any>
+    local loadingModules = {} ---@type table<string, true?>
+
+    ---@param modulePath string
+    ---@return string
+    local function getResourceNameFromModulePath(modulePath)
+        local externalResourceName = modulePath:match("^@(.-)%.")
+        if externalResourceName then
+            return externalResourceName
+        end
+
+        return _resourceName
+    end
+
+    ---@param modulePath string
+    ---@return string, number
+    local function getModuleFilePath(modulePath)
+        if modulePath:sub(1, 1) == "@" then
+            modulePath = modulePath:sub(modulePath:find("%.") + 1)
+        end
+
+        return modulePath:gsub("%.", "/")
+    end
+
+    ---@param modulePath string
+    ---@return any
+    function require(modulePath)
+        assert(type(modulePath) == "string", "Module path must be a string")
+
+        if loadingModules[modulePath] then
+            error(("Circular dependency detected for module '%s'."):format(modulePath))
+        end
+
+        if cachedModules[modulePath] then
+            return cachedModules[modulePath]
+        end
+
+        loadingModules[modulePath] = true
+
+        local resourceName = getResourceNameFromModulePath(modulePath)
+        local moduleFilePath = getModuleFilePath(modulePath)
+        local moduleFileContent = LoadResourceFile(resourceName, moduleFilePath .. ".lua")
+
+        if not moduleFileContent then
+            loadingModules[modulePath] = nil
+            error(("Module '%s' not found in resource '%s'."):format(moduleFilePath, resourceName))
+        end
+
+        local chunk, err = load(moduleFileContent, ("@%s/%s"):format(resourceName, moduleFilePath), "t")
+
+        if not chunk then
+            loadingModules[modulePath] = nil
+            error(("Failed to load module '%s': %s"):format(moduleFilePath, err))
+        end
+
+        local result = chunk()
+
+        cachedModules[modulePath] = result ~= nil and result or true
+        loadingModules[modulePath] = nil
+
+        return result
+    end
+end