@alias doesn't have a "file" property in doc json

[tommaisey]

How are you using the lua-language-server?

Command Line

Which OS are you using?

MacOS

What is the issue affecting?

Other

Expected Behaviour

In the documatation JSON output, most parsed declarations have a "file" property in the objects in the "defines" array. @alias declarations (with "type": "doc.alias") should have this as well.

Actual Behaviour

@alias declarations (with "type": "doc.alias") have no "file" property.

Reproduction steps

Write this Lua file:

---@alias foo
---| "a"
---| "b"

Then run:

lua-language-server --doc=. --doc_out_path=.

Check the doc.json file. The element with "name": "foo" should have a "file" property in its first "defines" object, but does not.

[tommaisey]

I noticed the same is true of @enum.

In both cases it would also be nice to include the original alias name in @param definitions that reference the alias/enum.

I'm going to set aside a few hours today to make a PR for these changes.

[tommaisey]

Ok, I noticed that we can have the alias name in @param definitions that reference an alias, by specifying ["Lua.hover.expandAlias"] = false in the config when generating docs. However, without access to the file and description of the alias/enum that doesn't help much, so I'll focus on getting those into the JSON.