feat: support link references

grammar.js

@@ -44,6 +44,7 @@ module.exports = grammar({
       $.enum_annotation,
       $.language_injection,
       $.see_reference,
+      $.link_reference,
     ),
 
     class_annotation: $ => seq(
@@ -155,6 +156,15 @@ module.exports = grammar({
 
     see_reference: $ => seq('@see', $.type, optional($.comment)),
 
+    link_reference: $ => seq(
+      alias(token(prec(-1, /[^\r\n{]+/)), $.comment),
+      '{',
+      '@link',
+      $.type,
+      '}',
+      optional($.comment),
+    ),
+
     qualifier: _ => choice('public', 'protected', 'private', 'package'),
 
     class_at_comment: $ => seq(

test/corpus/annotations.txt

@@ -292,3 +292,17 @@ Test Class Types
         (identifier))
       (identifier))
     (comment)))
+
+=========================
+Test a Link Reference
+=========================
+
+is of type {@link CodeAction} or a Thenable that resolves to such.
+
+---
+
+(documentation
+  (link_reference
+    (comment)
+    (identifier)
+    (comment)))