Add type annotations for lua API

Expected behavior of the wanted feature

There is lua language server that provides a type annotation system called luacats.

I have generated it from the document myself before using some simple regex, see https://github.com/ofseed/mpv/blob/main/types/mp.lua.

It is useful if you write mpv scripts with the language server because you can auto-complete APIs provided by mpv or read the docs immediately by hovering, Here is the showcase:

If you are interested, I could write a more accurate script or github workflow using tree-sitter or python packages to generate it automated in this repository.

Alternative behavior of the wanted feature

1. Provide these types in another repository.
2. Write annotations directly and generate the .rst file from it.

Log File

No response

Sample Files

No response

Start with the existing generated types/mp.lua example and the linked LuaLS/luacats annotation documentation, then compare it with the current mpv API documentation. Done means a repository-supported annotation source or generator is defined and the resulting Lua API types are available for language-server completion and hover documentation.