Deprecating functions using declaration syntax

[petrihakkinen]

It seems it is not possible to deprecate functions using the declaration syntax (yet).

Currently what we do as a workaround:

• Insert and parse magic comments in declaration files such as --@deprecated Use xyz instead
• Since there seems to be no way to inject 'deprecated' and 'deprecatedSuggestion' for modules from code [*], we implement and execute our own version of DeprecatedApi visitor in a custom pass, which we can feed a list of deprecated functions.

[*] Since modules are loaded via Luau::FileResolver there seems to be no place to set 'deprecated' flag for functions in modules before the linter executes its deprecated api visitor.

Needless to say, parsing the magic comments is quite fragile and replicating the api visitor is not ideal either...

Any suggestions?

[vegorov-rbx]

You can try using the customModuleCheck in FrontendOptions to update some things before the lint.

[petrihakkinen]

Thanks, I'll try that.

Is support for deprecated attribute in declarations planned?

[vegorov-rbx]

Yes, it is planned.
We have an implementation started, but it stumbled upon scheduling issues.
I will see how we can get it done.

[vegorov-rbx]

We are continuing work on it next week.