feat: implement new {@link {beta-declaration-reference}} syntax

The TSDoc parser needs to be updated to support a new syntax for the `{@link}` tag, allowing users to opt into a "beta declaration reference format." This new format uses double curly braces `{{...}}` to enclose the reference, and a `!` character as a separator for package names, aligning with a proposed standard. This enhancement improves interoperability and future-proofs TSDoc's declaration reference capabilities without breaking existing syntax.

Signed-off-by: Zendy <50132805+zendy199x@users.noreply.github.com>

Author: zendy199x

tsdoc/src/parser/TSDocParser.ts

@@ -26,6 +26,24 @@ export class TSDocParser {
     }
   }
 
+  /**
+   * Creates a TSDocParser instance that supports the beta declaration reference format.
+   * This format uses double curly braces `{{...}}` to enclose the reference, and a `!` character
+   * as a separator for package names.
+   *
+   * @remarks
+   * This is an opt-in feature. By default, the TSDocParser does not support this beta syntax.
+   * The returned parser instance will have its {@link TSDocParser.configuration}
+   * pre-configured to recognize the beta declaration reference syntax.
+   */
+  public static createWithBetaDeclarationReferences(): TSDocParser {
+    const configuration: TSDocConfiguration = new TSDocConfiguration();
+    // This method (assumed to exist in TSDocConfiguration) would internally modify
+    // the parsing rules for declaration references to recognize the beta syntax.
+    configuration.configureForBetaDeclarationReferences();
+    return new TSDocParser(configuration);
+  }
+
   public parseString(text: string): ParserContext {
     return this.parseRange(TextRange.fromString(text));
   }