Table: fix annotations, remove defMerge alias from Item, Node, and Tool

This commit is contained in:
Van
2026-05-19 17:14:56 +03:00
parent bd1059f9d7
commit 85aaf470f7
4 changed files with 21 additions and 33 deletions

View File

@@ -158,12 +158,6 @@ local function registerTool(luantiDef)
core.register_tool(':'..name, luantiDef)
end
---The alias `table.merge` for EmmyLua
---@type fun(...):(Item.ItemDefinition)
local defMerge = function(...)
return tableMerge(...)
end
---@param itemDef Item.ItemDefinition|Node.NodeDefinition
---@return Item
function Item:new(itemDef)
@@ -174,8 +168,9 @@ function Item:new(itemDef)
itemDef = tableCopy(itemDef)
-- Adding default parameters
itemDef = defMerge(itemDef, self.defaultDef, true)
-- Adding default parameterss
---@type Item.ItemDefinition
itemDef = tableMerge(itemDef, self.defaultDef, true)
local s = itemDef.settings
local shortModName = Mod.getInfo().shortName
@@ -223,7 +218,7 @@ end
---@param defaultDef Item.ItemDefinition
---@return Item
function Item:getExtended(defaultDef)
defaultDef = defMerge(defaultDef, self.defaultDef, true)
defaultDef = tableMerge(defaultDef, self.defaultDef, true)
---@type Item
local ChildClass = extend(self, {
@@ -240,7 +235,7 @@ function Item:getFactory(defaultDef)
if defaultDef == nil then
defaultDef = self.defaultDef
else
defaultDef = defMerge(self.defaultDef, defaultDef, true)
defaultDef = tableMerge(self.defaultDef, defaultDef, true)
end
---@type ItemFactory

View File

@@ -1,15 +1,11 @@
local tableMerge = table.merge
local Item, ItemFactory = Smc.requireItem(), Smc.requireItemFactory()
---@class Node : Item
---@field defaultDef Node.NodeDefinition
local Node = Class.extend(Item, {})
---The alias `table.merge` for EmmyLua
---@type fun(...):(Node.NodeDefinition)
local defMerge = function(...)
return table.merge(...)
end
---@param nodeDef Node.NodeDefinition
local function registerSlab(nodeDef)
nodeDef = table.copy_with_metatables(nodeDef)
@@ -71,7 +67,7 @@ end
---@return Node
function Node:new(nodeDef)
-- Adding default parameters.
nodeDef = defMerge(nodeDef, self.defaultDef, true)
nodeDef = tableMerge(nodeDef, self.defaultDef, true)
local settings = nodeDef.settings
settings._type = 'node'
@@ -103,7 +99,7 @@ end
---@param defaultDef Node.NodeDefinition
---@return Node
function Node:getExtended(defaultDef)
defaultDef = defMerge(defaultDef, self.defaultDef, true)
defaultDef = tableMerge(defaultDef, self.defaultDef, true)
---@type Node
local ChildClass = Class.extend(self, {
@@ -120,7 +116,7 @@ function Node:getFactory(defaultDef)
if defaultDef == nil then
defaultDef = self.defaultDef
else
defaultDef = defMerge(self.defaultDef, defaultDef, true)
defaultDef = tableMerge(self.defaultDef, defaultDef, true)
end
---@type ItemFactory

View File

@@ -1,20 +1,16 @@
local tableMerge = table.merge
local Item, ItemFactory = Smc.requireItem(), Smc.requireItemFactory()
---@class Tool : Item
---@field defaultDef Item.ItemDefinition
local Tool = Class.extend(Item, {})
---The alias `table.merge` for EmmyLua
---@type fun(...):(Item.ItemDefinition)
local defMerge = function(...)
return table.merge(...)
end
---@param ToolDef Item.ItemDefinition
---@return Tool
function Tool:new(ToolDef)
---Adding default parameters
ToolDef = defMerge(ToolDef, self.defaultDef, true)
ToolDef = tableMerge(ToolDef, self.defaultDef, true)
ToolDef.settings._type = 'tool'
@@ -29,7 +25,7 @@ end
---@param defaultDef Item.ItemDefinition
---@return Tool
function Tool:getExtended(defaultDef)
defaultDef = defMerge(defaultDef, self.defaultDef, true)
defaultDef = tableMerge(defaultDef, self.defaultDef, true)
---@type Tool
local ChildClass = Class.extend(self, {
@@ -46,7 +42,7 @@ function Tool:getFactory(defaultDef)
if defaultDef == nil then
defaultDef = self.defaultDef
else
defaultDef = defMerge(self.defaultDef, defaultDef, true)
defaultDef = tableMerge(self.defaultDef, defaultDef, true)
end
---@type ItemFactory

View File

@@ -156,11 +156,12 @@ local function mergeInPlace(target, source, recursively)
end
--- Merges entries from `t2` into a deep copy of `t1`, skipping existing keys.
--- @generic T
--- @param t1 T Target table to merge into
--- @param t2 table Source table to merge from
--- @param recursively? boolean Enable recursive merging (default: false)
--- @return T
--- @generic T table
--- @overload fun(t1:T, t2:T, recursively:boolean?):T
--- @param t1 table Target table to merge into
--- @param t2 table Source table to merge from
--- @param recursively boolean? Enable recursive merging (default: false)
--- @return table
function table.merge(t1, t2, recursively)
ensureArgType(t1, 'table', 1, 'table.merge')
ensureArgType(t2, 'table', 2, 'table.merge')