feature request: attach a `reason` parameter to `@nodiscard`

[!NOTE]
I couldn't find an issue for this. sorry if there's a duplicate.

I propose updating the @nodiscard annotation to add a "reason" as to why not discard the value:

---@nodiscard [<reason>]

this would mirror Rust's #[must_use = "reason"] annotation.

example:

---Creates a new class that inherits from this one.
---@return Class
---@nodiscard This method returns the new class; it's pointless to immediately discard it.
function Object:extend()
  -- ...
end

discarding the output would then display the warning:

* [warning][Lua Diagnostics.][discard-returns]
  The return values of this function cannot be discarded:
  This method returns the new class; it's pointless to immediately discard it.

note the colon at the end of "discarded".
if not given a reason, it would fall-back to the usual message, with "discarded" ending with a dot and no further explanation
(yes, I'm aware that reason in the Object:extend example isn't exactly... professional 😅)

No se nombra ningún archivo ni prueba. Empieza por localizar el analizador de anotaciones @nodiscard y el diagnóstico discard-returns; después, sigue cómo llega el texto de la anotación a esa advertencia. Se considera terminado cuando se muestra un motivo proporcionado con los dos puntos solicitados, mientras que omitir el motivo conserva el mensaje y el punto existentes.