Is the @return_single_parameter annotation safe to use?

[grncdr]

While hacking on solargraph-rails I've discovered that Solargraph has a mechanism for annotating methods as returning "the generic" from a method chain. I've used this to annotate ActiveRecord::FinderMethods#first in my hacks branch. This makes it possible to write code like User.find(123).posts.active.where("...").first and actually get Post as the return type of #first.

My question is: is it likely that this capability will be removed without replacement in future Solargraph releases? In general it's really tricky to refer to generic types using YARD syntax, but I hope that this little hack stays in place as long as Solargraph is using YARD.

[grncdr]

Same question applies to @yieldparam_single_parameter, which I'm now using to type ActiveRecord::Batches#find_each