How to write annotation for an array that each element is a union of two types?

[linrongbin16]

Hi, based on this wiki: https://github.com/LuaLS/lua-language-server/wiki/Annotations#documenting-types, I'm still not sure how should I write an array, that each element is a union of two types.

For example either integer or string:

-- version-1
--- @type string|integer[]

-- version-2
--- @type string[]|integer[]

-- version-3
--- @alias MyStringOrInteger string|integer
--- @type MyStringOrInteger[]

I guess using @alias should be correct?

And what about an array, that either all of the elements are strings, or all of the elements are integers?

--- @alias MyStringArray string[]
--- @alias MyIntegerArray integer[]
--- @type MyStringArray|MyIntegerArray

[carsakiller]

There are multiple ways that this could be typed:

---@type (string|integer)[]
local a = {}

---@type table<integer, string | integer>
local a = {}

---@alias Array<T> T[]
---@type Array<string | integer>
local a = {}

[carsakiller]

I have updated the wiki with the first example under the Documenting Types section.

[linrongbin16]

thanks, the last method looks good to me