Add deprecated related feature

Author: Kingwl

src/compiler/factoryPublic.ts

@@ -2595,6 +2595,10 @@ namespace ts {
         return createJSDocTag(SyntaxKind.JSDocAuthorTag, "author", comment);
     }
 
+    export function createJSDocDeprecatedTag(comment?: string) {
+        return createJSDocTag(SyntaxKind.JSDocDeprecatedTag, "deprecated", comment);
+    }
+
     export function createJSDocPublicTag() {
         return createJSDocTag(SyntaxKind.JSDocPublicTag, "public");
     }

src/compiler/parser.ts

@@ -7065,6 +7065,9 @@ namespace ts {
                         case "readonly":
                             tag = parseSimpleTag(start, SyntaxKind.JSDocReadonlyTag, tagName);
                             break;
+                        case "deprecated":
+                            tag = parseSimpleTag(start, SyntaxKind.JSDocDeprecatedTag, tagName);
+                            break;
                         case "this":
                             tag = parseThisTag(start, tagName);
                             break;

src/compiler/types.ts

@@ -473,6 +473,7 @@ namespace ts {
         JSDocAugmentsTag,
         JSDocImplementsTag,
         JSDocAuthorTag,
+        JSDocDeprecatedTag,
         JSDocClassTag,
         JSDocPublicTag,
         JSDocPrivateTag,
@@ -2676,6 +2677,10 @@ namespace ts {
         kind: SyntaxKind.JSDocAuthorTag;
     }
 
+    export interface JSDocDeprecatedTag extends JSDocTag {
+        kind: SyntaxKind.JSDocDeprecatedTag;
+    }
+
     export interface JSDocClassTag extends JSDocTag {
         kind: SyntaxKind.JSDocClassTag;
     }

src/compiler/utilitiesPublic.ts

@@ -759,6 +759,11 @@ namespace ts {
         return getFirstJSDocTag(node, isJSDocTemplateTag);
     }
 
+    /** Gets the JSDoc deprecated tag for the node if present */
+    export function getJSDocDeprecatedTag(node: Node): JSDocDeprecatedTag | undefined {
+        return getFirstJSDocTag(node, isJSDocDeprecatedTag);
+    }
+
     /** Gets the JSDoc type tag for the node if present and valid */
     export function getJSDocTypeTag(node: Node): JSDocTypeTag | undefined {
         // We should have already issued an error if there were multiple type jsdocs, so just use the first one.
@@ -1692,6 +1697,10 @@ namespace ts {
         return node.kind === SyntaxKind.JSDocTemplateTag;
     }
 
+    export function isJSDocDeprecatedTag(node: Node): node is JSDocDeprecatedTag {
+        return node.kind === SyntaxKind.JSDocDeprecatedTag;
+    }
+
     export function isJSDocTypedefTag(node: Node): node is JSDocTypedefTag {
         return node.kind === SyntaxKind.JSDocTypedefTag;
     }

src/harness/client.ts

@@ -242,6 +242,7 @@ namespace ts.server {
                 isCaseSensitive: entry.isCaseSensitive,
                 fileName: entry.file,
                 textSpan: this.decodeSpan(entry),
+                isDeprecated: !!entry.tags?.includes(protocol.SymbolTag.Deprecated)
             }));
         }
 

src/harness/fourslashImpl.ts

@@ -2982,6 +2982,7 @@ namespace FourSlash {
                     textSpan: ts.createTextSpanFromRange(e.range),
                     containerName: e.containerName || "",
                     containerKind: e.containerKind || ts.ScriptElementKind.unknown,
+                    isDeprecated: !!e.isDeprecated
                 })));
             }
         }

src/harness/fourslashInterfaceImpl.ts

@@ -1541,6 +1541,7 @@ namespace FourSlashInterface {
         readonly range: FourSlash.Range;
         readonly containerName?: string;
         readonly containerKind?: ts.ScriptElementKind;
+        readonly isDeprecated?: boolean
     }
 
     export type ArrayOrSingle<T> = T | readonly T[];

src/server/protocol.ts

@@ -2818,6 +2818,10 @@ namespace ts.server.protocol {
         arguments: NavtoRequestArgs;
     }
 
+    export enum SymbolTag {
+        Deprecated = 1
+    }
+
     /**
      * An item found in a navto response.
      */
@@ -2857,6 +2861,11 @@ namespace ts.server.protocol {
          * Kind of symbol's container symbol (if any).
          */
         containerKind?: ScriptElementKind;
+
+        /**
+         * The symbol's tag.
+         */
+        tags?: SymbolTag[]
     }
 
     /**

src/server/session.ts

@@ -1886,7 +1886,8 @@ namespace ts.server {
                     matchKind: navItem.matchKind,
                     file: navItem.fileName,
                     start: scriptInfo.positionToLineOffset(navItem.textSpan.start),
-                    end: scriptInfo.positionToLineOffset(textSpanEnd(navItem.textSpan))
+                    end: scriptInfo.positionToLineOffset(textSpanEnd(navItem.textSpan)),
+                    tags: navItem.isDeprecated ? [protocol.SymbolTag.Deprecated] : undefined
                 };
                 if (navItem.kindModifiers && (navItem.kindModifiers !== "")) {
                     bakedItem.kindModifiers = navItem.kindModifiers;

src/services/navigateTo.ts

@@ -131,6 +131,7 @@ namespace ts.NavigateTo {
             // TODO(jfreeman): What should be the containerName when the container has a computed name?
             containerName: containerName ? (<Identifier>containerName).text : "",
             containerKind: containerName ? getNodeKind(container!) : ScriptElementKind.unknown, // TODO: GH#18217 Just use `container ? ...`
+            isDeprecated: !!getJSDocDeprecatedTag(rawItem.declaration)
         };
     }
 }