First commit, step 4 completed

docs/annotations/Annotations/Core/Lua/table.lua

@@ -0,0 +1,131 @@
+---@meta table_wow
+--- added: table.removemulti, table.wipe
+--- removed: table.move, table.pack, table.unpack
+--- obsolete-removed: table.setn
+--- unpack is in basic.lua
+
+---
+---
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table"])
+---
+---@class tablelib
+table = {}
+
+---
+---Given a list where all elements are strings or numbers, returns the string `list[i]..sep..list[i+1] ··· sep..list[j]`.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.concat"])
+---
+---@param list table
+---@param sep? string
+---@param i?   integer
+---@param j?   integer
+---@return string
+---@nodiscard
+function table.concat(list, sep, i, j) end
+
+---[Documentation](https://warcraft.wiki.gg/wiki/API_table.count)
+---@param tbl table
+---@return number numTableNodes Total number of elements within the table
+---@return number numArrayNodes Total number of elements within the table that had integral keys in the range [1..numTableNodes]" 
+---@return number maxArrayIndex Largest integral key within the table, or zero if no such keys were found"
+function table.count(tbl) end
+
+---[Documentation](https://warcraft.wiki.gg/wiki/API_table.create)
+---@param arraySizeHint number
+---@param nodeSizeHint? number
+---@return table
+---@nodiscard
+function table.create(arraySizeHint, nodeSizeHint) end
+
+---
+---Inserts element `value` at position `pos` in `list`.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.insert"])
+---
+---@overload fun(list: table, value: any)
+---@param list table
+---@param pos integer
+---@param value any
+function table.insert(list, pos, value) end
+
+---Returns the largest positive numerical index of the given table, or zero if the table has no positive numerical indices.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.maxn"])
+---
+---@param tbl table
+---@return integer
+---@nodiscard
+function table.maxn(tbl) end
+
+---
+---Removes from `list` the element at position `pos`, returning the value of the removed element.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.remove"])
+---
+---@param list table
+---@param pos? integer
+---@return any
+function table.remove(list, pos) end
+
+---
+---Sorts list elements in a given order, *in-place*, from `list[1]` to `list[#list]`.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.sort"])
+---
+---@generic T
+---@param list T[]
+---@param comp? fun(a: T, b: T):boolean
+function table.sort(list, comp) end
+
+---Executes the given f over all elements of table. For each element, f is called with the index and respective value as arguments. If f returns a non-nil value, then the loop is broken, and this value is returned as the final value of foreach.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.foreach"])
+---
+---@generic T
+---@param list any
+---@param callback fun(key: string, value: any):T|nil
+---@return T|nil
+---@deprecated
+function table.foreach(list, callback) end
+
+---Executes the given f over the numerical indices of table. For each index, f is called with the index and respective value as arguments. Indices are visited in sequential order, from 1 to n, where n is the size of the table. If f returns a non-nil value, then the loop is broken and this value is returned as the result of foreachi.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.foreachi"])
+---
+---@generic T
+---@param list any
+---@param callback fun(key: string, value: any):T|nil
+---@return T|nil
+---@deprecated
+function table.foreachi(list, callback) end
+
+---Returns the number of elements in the table. This function is equivalent to `#list`.
+---
+---[View documents](command:extension.lua.doc?["en-us/51/manual.html/pdf-table.getn"]), [Wiki](https://warcraft.wiki.gg/wiki/API_table.getn)
+---
+---@generic T
+---@param list T[]
+---@return integer
+---@nodiscard
+---@deprecated
+function table.getn(list) end
+
+---Removes `count` elements from a table starting at index `pos`.
+---
+---[Wiki](https://warcraft.wiki.gg/wiki/API_table.removemulti)
+---
+---@param list table
+---@param pos? integer
+---@return any
+function table.removemulti(list, pos, count) end
+
+---Wipes a table of all contents.
+---
+---[Wiki](https://warcraft.wiki.gg/wiki/API_wipe)
+---@param tbl table
+---@return table
+function table.wipe(tbl) end
+
+return table