@thigasdevelopment/luam 0.19.12 → 1.0.1

package/lua/string.lua

@@ -1,82 +1,98 @@
-local function trim(value)
-    if type(value) ~= 'string' then
-        return tostring(value)
-    end
-
-    return value:match('^%s*(.-)%s*$') or ''
+---@param value any
+---@return string
+local function trim (value)
+	if (type (value) ~= 'string') then
+		return tostring (value);
+	end
+
+	return value:match ('^%s*(.-)%s*$') or '';
 end
 
-local function resolve(context, path)
-    local current = context
-
-    for key in path:gmatch('[^%.]+') do
-        if type(current) ~= 'table' then
-            return nil
-        end
+---@param context table
+---@param path string
+---@return any
+local function resolve (context, path)
+	local current = context;
 
-        current = current[key]
+	for key in path:gmatch ('[^%.]+') do
+		if (type (current) ~= 'table') then
+			return nil;
+		end
 
-        if current == nil then
-            return nil
-        end
-    end
+		current = current[key];
+		if (current == nil) then
+			return nil;
+		end
+	end
 
-    return current
+	return current;
 end
 
-local function parse(raw)
-    local key, rest = raw:match('^(.-):(.+)$')
+---@param raw string
+---@return string, string?
+local function parse (raw)
+	local key, rest = raw:match ('^(.-):(.+)$');
+	if (not key) then
+		return raw, nil;
+	end
 
-    if not key then
-        return raw, nil
-    end
-
-    return key, trim(rest:match('^([^:]+)'))
+	return key, trim (rest:match ('^([^:]+)'));
 end
 
-function string.trim(value)
-    return trim(value)
+---@param value any
+---@return string
+function string.trim (value)
+	return trim (value);
 end
 
-function string.startsWith(value, prefix)
-    if type(value) ~= 'string' or type(prefix) ~= 'string' then
-        return false
-    end
+---@param value string
+---@param prefix string
+---@return boolean
+function string.startsWith (value, prefix)
+	if (type (value) ~= 'string') or (type (prefix) ~= 'string') then
+		return false;
+	end
 
-    return value:sub(1, prefix:len()) == prefix
+	return value:sub (1, prefix:len ()) == prefix;
 end
 
-function string.endsWith(value, suffix)
-    if type(value) ~= 'string' or type(suffix) ~= 'string' then
-        return false
-    end
+---@param value string
+---@param suffix string
+---@return boolean
+function string.endsWith (value, suffix)
+	if (type (value) ~= 'string') or (type (suffix) ~= 'string') then
+		return false;
+	end
 
-    if suffix == '' then
-        return true
-    end
+	if (suffix == '') then
+		return true;
+	end
 
-    return value:sub(-suffix:len()) == suffix
+	return value:sub (-suffix:len ()) == suffix;
 end
 
-function string.template(text, context)
-    if type(text) ~= 'string' then
-        return tostring(text)
-    end
-
-    if type(context) ~= 'table' or next(context) == nil then
-        return text
-    end
-
-    return (
-        text:gsub('%${(.-)}', function(raw)
-            local key, default = parse(trim(raw))
-            local value = resolve(context, trim(key))
-
-            if value == nil then
-                return default ~= nil and default or ''
-            end
-
-            return tostring(value)
-        end)
-    )
+---@param text string
+---@param context table
+---@return string
+function string.template (text, context)
+	if (type (text) ~= 'string') then
+		return tostring (text);
+	end
+
+	if (type (context) ~= 'table') or (next (context) == nil) then
+		return text;
+	end
+
+	return (
+		text:gsub ('%${(.-)}', function (raw)
+			local key, default = parse (trim (raw));
+			local value = resolve (context, trim (key));
+
+			if (value == nil) then
+				return default ~= nil and default or '';
+			end
+
+			return tostring (value);
+		end)
+	);
 end

package/lua/table.lua

@@ -1,63 +1,71 @@
-function table.size(value)
-    local size = 0
-
-    if type(value) ~= 'table' then
-        return size
-    end
-
-    for _ in pairs(value) do
-        size = size + 1
-    end
-
-    return size
+---@param value table
+---@return number
+function table.size (value)
+	local size = 0;
+	if (type (value) ~= 'table') then
+		return size;
+	end
+
+	for _ in pairs (value) do
+		size = size + 1;
+	end
+
+	return size;
 end
 
-function table.isEmpty(value)
-    if type(value) ~= 'table' then
-        return true
-    end
+---@param value table
+---@return boolean
+function table.isEmpty (value)
+	if (type (value) ~= 'table') then
+		return true;
+	end
 
-    return next(value) == nil
+	return next (value) == nil;
 end
 
-function table.keys(value)
-    local keys = {}
-
-    if type(value) ~= 'table' then
-        return keys
-    end
+---@param value table
+---@return table
+function table.keys (value)
+	local keys = { };
+	if (type (value) ~= 'table') then
+		return keys;
+	end
 
-    for key in pairs(value) do
-        keys[#keys + 1] = key
-    end
+	for key in pairs (value) do
+		keys[#keys + 1] = key;
+	end
 
-    return keys
+	return keys;
 end
 
-function table.values(value)
-    local values = {}
+---@param value table
+---@return table
+function table.values (value)
+	local values = { };
+	if (type (value) ~= 'table') then
+		return values;
+	end
 
-    if type(value) ~= 'table' then
-        return values
-    end
+	for _, item in pairs (value) do
+		values[#values + 1] = item;
+	end
 
-    for _, item in pairs(value) do
-        values[#values + 1] = item
-    end
-
-    return values
+	return values;
 end
 
-function table.includes(value, item)
-    if type(value) ~= 'table' then
-        return false
-    end
-
-    for _, current in pairs(value) do
-        if current == item then
-            return true
-        end
-    end
-
-    return false
+---@param value table
+---@param item any
+---@return boolean
+function table.includes (value, item)
+	if (type (value) ~= 'table') then
+		return false;
+	end
+
+	for _, current in pairs (value) do
+		if (current == item) then
+			return true;
+		end
+	end
+
+	return false;
 end