feat: enhance string utilities and fix forEach callback

imports/array/shared.lua

@@ -193,10 +193,10 @@ function lib.array:indexOf(value, last)
 end
 
 ---Executes the provided function for each element in an array.
----@param cb fun(element: unknown)
+---@param cb fun(element: unknown, index: number)
 function lib.array:forEach(cb)
     for i = 1, #self do
-        cb(self[i])
+        cb(self[i], i)
     end
 end
 

imports/string/shared.lua

@@ -63,4 +63,66 @@ function string.random(pattern, length)
     return table.concat(arr)
 end
 
+--[[
+    Make any output with more modern pattern
+
+    const data = {
+        name = 'John',
+        secondName = 'Rose'
+    }
+    print(string.interpolate('Hello ${name}, I am ${secondName}', data))
+]]
+---@param str string
+---@param vars table<string, string>
+---@return string formattedString
+function string.interpolate(str, vars)
+    return (str:gsub('($%b{})', function(w)
+        local key = w:sub(3, -2)
+        return tostring(vars[key] or w)
+    end))
+end
+
+--- Removes leading and trailing whitespace from a string
+---@param str string
+---@return string trimmedString
+function string.trim(str)
+    return str:match('^%s*(.-)%s*$')
+end
+
+--- Checks if a string starts with the specified prefix
+---@param str string
+---@param prefix string
+---@return boolean
+function string.startsWith(str, prefix)
+    return str:sub(1, #prefix) == prefix
+end
+
+--- Checks if a string ends with the specified suffix
+---@param str string
+---@param suffix string
+---@return boolean
+function string.endsWith(str, suffix)
+    return suffix == '' or str:sub(-#suffix) == suffix
+end
+
+--- Capitalizes the first character of a string and lowers the rest
+---@param str string
+---@return string capitalizedString
+function string.capitalize(str)
+    return (str:lower():gsub('^%l', string.upper))
+end
+
+--- Shortens a string to a specific length and appends a suffix
+---@param str string
+---@param length integer
+---@param suffix string
+---@return string truncatedString
+function string.truncate(str, length, suffix)
+    suffix = suffix or '...'
+    if #str <= length then
+        return str
+    end
+    return str:sub(1, length) .. suffix
+end
+
 return lib.string