Do not attempt to resolve includes as links

Resolves #1986

Author: Gerrit0

CHANGELOG.md

@@ -5,6 +5,10 @@
 -   Improved support for `--entryPointStrategy Packages`. TypeDoc will now load package-specific configurations from `package.json` `typedoc` field. This configuration allows configuring a custom display name (`typedoc.displayName`) field, entry point (`typedoc.entryPoint` - this is equivalent and will override `typedocMain`), and path to a readme file to be rendered at the top of the package page (`typedoc.readmeFile`), #1658.
 -   The `--includeVersion` option will now be respected by `--entryPointStrategy Packages`. Also, for this combination, missing `version` field in the root `package.json` will not issue a warning.
 
+### Bug Fixes
+
+-   Include references will no longer be incorrectly parsed as links, #1986.
+
 ## v0.23.5 (2022-07-02)
 
 ### Features

src/lib/converter/plugins/LinkResolverPlugin.ts

@@ -13,7 +13,7 @@ import type {
 import { DeclarationReflection } from "../../models";
 
 const urlPrefix = /^(http|ftp)s?:\/\//;
-const brackets = /\[\[([^\]]+)\]\]/g;
+const brackets = /\[\[(?!include:)([^\]]+)\]\]/g;
 /**
  * A plugin that resolves `{@link Foo}` tags.
  */

src/test/converter2/issues/gh1986.ts

@@ -0,0 +1,4 @@
+/**
+ * [[include:file.md]] this is not a link.
+ */
+export const a = 123;

src/test/issueTests.ts

@@ -598,4 +598,14 @@ export const issueTests: {
 
         equal(comments2, ["Comment for a", "Comment for b"]);
     },
+
+    gh1986(project, logger) {
+        const a = query(project, "a");
+        equal(
+            Comment.combineDisplayParts(a.comment?.summary),
+            "[[include:file.md]] this is not a link."
+        );
+        logger.discardDebugMessages();
+        logger.expectNoOtherMessages();
+    },
 };