fix(43796): sort deprecated completions lower than others

Author: a-tarasyuk

src/services/completions.ts

@@ -100,10 +100,6 @@ namespace ts.SymbolDisplay {
         return ScriptElementKind.unknown;
     }
 
-    function isDeprecatedDeclaration(decl: Declaration) {
-        return !!(getCombinedNodeFlagsAlwaysIncludeJSDoc(decl) & ModifierFlags.Deprecated);
-    }
-
     function getNormalizedSymbolModifiers(symbol: Symbol) {
         if (symbol.declarations && symbol.declarations.length) {
             const [declaration, ...declarations] = symbol.declarations;

src/services/symbolDisplay.ts

@@ -3352,5 +3352,9 @@ namespace ts {
             || (!!globalCachePath && startsWith(getCanonicalFileName(globalCachePath), toNodeModulesParent));
     }
 
+    export function isDeprecatedDeclaration(decl: Declaration) {
+        return !!(getCombinedNodeFlagsAlwaysIncludeJSDoc(decl) & ModifierFlags.Deprecated);
+    }
+
     // #endregion
 }

src/services/utilities.ts

@@ -302,21 +302,21 @@
           "name": "a",
           "kind": "warning",
           "kindModifiers": "",
-          "sortText": "7",
+          "sortText": "14",
           "isFromUncheckedFile": true
         },
         {
           "name": "prototype",
           "kind": "warning",
           "kindModifiers": "",
-          "sortText": "7",
+          "sortText": "14",
           "isFromUncheckedFile": true
         },
         {
           "name": "m",
           "kind": "property",
           "kindModifiers": "",
-          "sortText": "7",
+          "sortText": "14",
           "isFromUncheckedFile": true,
           "displayParts": [
             {

tests/baselines/reference/completionsSalsaMethodsOnAssignedFunctionExpressions.baseline

@@ -25,27 +25,26 @@
 verify.completions({
     marker: "1",
     includes: [
-      { name: "Foo", kind: "interface", kindModifiers: "deprecated" }
+      { name: "Foo", kind: "interface", kindModifiers: "deprecated", sortText: completion.SortText.DeprecatedLocationPriority }
     ]
 }, {
     marker: "2",
     includes: [
-      { name: "bar", kind: "method", kindModifiers: "deprecated" }
+      { name: "bar", kind: "method", kindModifiers: "deprecated", sortText: completion.SortText.DeprecatedLocationPriority }
     ]
 }, {
     marker: "3",
     includes: [
-      { name: "prop", kind: "property", kindModifiers: "deprecated" }
+      { name: "prop", kind: "property", kindModifiers: "deprecated", sortText: completion.SortText.DeprecatedLocationPriority }
     ]
 }, {
     marker: "4",
     includes: [
-      { name: "foobar", kind: "function", kindModifiers: "export,deprecated" }
+      { name: "foobar", kind: "function", kindModifiers: "export,deprecated", sortText: completion.SortText.DeprecatedLocationPriority }
     ]
 }, {
     marker: "5",
     includes: [
-      { name: "foobar", kind: "alias", kindModifiers: "export,deprecated" }
+      { name: "foobar", kind: "alias", kindModifiers: "export,deprecated", sortText: completion.SortText.DeprecatedLocationPriority }
     ]
-}
-);
+});

tests/cases/fourslash/completionsWithDeprecatedTag1.ts

@@ -0,0 +1,24 @@
+/// <reference path="fourslash.ts" />
+
+// @Filename: /foo.ts
+/////** @deprecated foo */
+////export const foo = 0;
+
+// @Filename: /index.ts
+/////**/
+
+verify.completions({
+    marker: "",
+    includes: [{
+        name: "foo",
+        source: "/foo",
+        sourceDisplay: "./foo",
+        hasAction: true,
+        kind: "const",
+        kindModifiers: "export,deprecated",
+        sortText: completion.SortText.DeprecatedAutoImportSuggestions
+    }],
+    preferences: {
+        includeCompletionsForModuleExports: true,
+    },
+});

tests/cases/fourslash/completionsWithDeprecatedTag10.ts

@@ -9,7 +9,10 @@
 
 verify.completions({
     marker: "",
-    includes: [
-        { name: "foo", kind: "function", kindModifiers: "deprecated,declare" }
-    ]
+    includes: [{
+        name: "foo",
+        kind: "function",
+        kindModifiers: "deprecated,declare",
+        sortText: completion.SortText.DeprecatedLocationPriority
+    }]
 });

tests/cases/fourslash/completionsWithDeprecatedTag2.ts

@@ -9,7 +9,10 @@
 
 verify.completions({
     marker: "",
-    includes: [
-      { name: "foo", kind: "function", kindModifiers: "declare" }
-    ]
+    includes: [{
+        name: "foo",
+        kind: "function",
+        kindModifiers: "declare",
+        sortText: completion.SortText.LocationPriority
+    }]
 });

tests/cases/fourslash/completionsWithDeprecatedTag3.ts

@@ -0,0 +1,23 @@
+/// <reference path="fourslash.ts" />
+
+// @noLib: true
+
+////f({
+////    a/**/
+////    xyz: ``,
+////});
+////declare function f(options: {
+////    /** @deprecated abc */
+////    abc?: number,
+////    xyz?: string
+////}): void;
+
+verify.completions({
+    marker: "",
+    exact: [{
+        name: "abc",
+        kind: "property",
+        kindModifiers: "deprecated,declare,optional",
+        sortText: completion.SortText.DeprecatedOptionalMember
+    }],
+});

tests/cases/fourslash/completionsWithDeprecatedTag4.ts

@@ -0,0 +1,24 @@
+/// <reference path="fourslash.ts"/>
+
+////class Foo {
+////    /** @deprecated m */
+////    static m() {}
+////}
+////Foo./**/
+
+verify.completions({
+    marker: "",
+    exact: [
+        {
+            name: "prototype",
+            sortText: completion.SortText.LocationPriority
+        },
+        {
+            name: "m",
+            kind: "method",
+            kindModifiers: "static,deprecated",
+            sortText: completion.SortText.DeprecatedLocalDeclarationPriority
+        },
+        ...completion.functionMembers
+    ]
+});

tests/cases/fourslash/completionsWithDeprecatedTag5.ts

@@ -0,0 +1,17 @@
+/// <reference path="fourslash.ts"/>
+
+////module Foo {
+////    /** @deprecated foo */
+////    export var foo: number;
+////}
+////Foo./**/
+
+verify.completions({
+    marker: "",
+    exact: [{
+        name: "foo",
+        kind: "var",
+        kindModifiers: "export,deprecated",
+        sortText: completion.SortText.DeprecatedLocationPriority
+    }]
+});

tests/cases/fourslash/completionsWithDeprecatedTag6.ts

@@ -0,0 +1,27 @@
+/// <reference path="fourslash.ts" />
+
+// @strict: true
+
+////interface I {
+////    /** @deprecated a */
+////    a: number;
+////}
+
+////const foo = {
+////    a: 1
+////}
+
+////const i: I = {
+////    ...foo,
+////    /**/
+////}
+
+verify.completions({
+    marker: "",
+    exact: [{
+        name: "a",
+        sortText: completion.SortText.DeprecatedMemberDeclaredBySpreadAssignment,
+        kind: 'property',
+        kindModifiers: "deprecated"
+    }]
+});

tests/cases/fourslash/completionsWithDeprecatedTag7.ts

@@ -0,0 +1,25 @@
+/// <reference path="fourslash.ts" />
+
+////class C {
+////    /** @deprecated */
+////    p: number;
+////    m() {
+////        return (/**/)
+////    }
+////}
+
+verify.completions({
+    marker: "",
+    includes: [{
+        name: "p",
+        kind: "property",
+        kindModifiers: "deprecated",
+        insertText: "this.p",
+        sortText: completion.SortText.DeprecatedSuggestedClassMembers,
+        source: completion.CompletionSource.ThisProperty
+    }],
+    preferences: {
+        includeInsertTextCompletions: true
+    },
+    isNewIdentifierLocation: true
+});

tests/cases/fourslash/completionsWithDeprecatedTag8.ts

@@ -0,0 +1,30 @@
+/// <reference path="fourslash.ts" />
+
+// @lib: dom
+// @allowJs: true
+
+// @Filename: globals.d.ts
+/////** @deprecated foo */
+////declare var foo: string;
+
+// @Filename: index.ts
+////class Foo {
+////    foo: number;
+////    m() {
+////        foo/**/
+////    }
+////}
+
+verify.completions({
+    marker: "",
+    includes: [{
+        name: "foo",
+        kind: "var",
+        kindModifiers: "deprecated,declare",
+        sortText: completion.SortText.DeprecatedGlobalsOrKeywords
+    }]
+}, {
+    preferences: {
+        includeInsertTextCompletions: true
+    }
+});

tests/cases/fourslash/completionsWithDeprecatedTag9.ts

@@ -796,7 +796,14 @@ declare namespace completion {
         SuggestedClassMembers = "4",
         GlobalsOrKeywords = "5",
         AutoImportSuggestions = "6",
-        JavascriptIdentifiers = "7"
+        DeprecatedLocalDeclarationPriority = "7",
+        DeprecatedLocationPriority = "8",
+        DeprecatedOptionalMember = "9",
+        DeprecatedMemberDeclaredBySpreadAssignment = "10",
+        DeprecatedSuggestedClassMembers = "11",
+        DeprecatedGlobalsOrKeywords = "12",
+        DeprecatedAutoImportSuggestions = "13",
+        JavascriptIdentifiers = "14"
     }
     export const enum CompletionSource {
         ThisProperty = "ThisProperty/"