How to describe __call metamethod?

[lua-rocks]

Is it possible to use table with __call as function and get hints about its arguments?

I can't overload class with function, right?

---@class lib.ansicolors
---@overload fun(str:string):string

... and giving function a name (id) using @class annotation also seems illegal ...

[lua-rocks]

Okay, I found not perfect, but still a solution.

I can give such functions a name using @alias annotation:

---@alias lib.ansicolors_call fun(str: string): string

...

---@type lib.ansicolors|lib.ansicolors_call
local ansicolors = require 'lib.ansicolors'

The problem is that this approach does not describe the actual function in the code and requires specifying the type after each require, but it works nevertheless.