Add quick pick hover support to explain conda environment lacking a Python interpreter (#21073)

Closes #20786

Author: Kartik Raj

package.json

@@ -21,7 +21,8 @@
         "contribEditorContentMenu",
         "quickPickSortByLabel",
         "envShellEvent",
-        "testObserver"
+        "testObserver",
+        "quickPickItemTooltip"
     ],
     "author": {
         "name": "Microsoft Corporation"

src/client/common/utils/localize.ts

@@ -221,6 +221,9 @@ export namespace Interpreters {
 }
 
 export namespace InterpreterQuickPickList {
+    export const condaEnvWithoutPythonTooltip = l10n.t(
+        'Python is not available in this environment, it will automatically be installed upon selecting it',
+    );
     export const noPythonInstalled = l10n.t('Python is not installed, please download and install it');
     export const clickForInstructions = l10n.t('Click for instructions...');
     export const globalGroupName = l10n.t('Global');

src/client/interpreter/configuration/interpreterSelector/commands/setInterpreter.ts

@@ -415,6 +415,7 @@ export class SetInterpreterCommand extends BaseInterpreterSelectorCommand implem
                     if (isInterpreterQuickPickItem(item) && isProblematicCondaEnvironment(item.interpreter)) {
                         if (!items[i].label.includes(Octicons.Warning)) {
                             items[i].label = `${Octicons.Warning} ${items[i].label}`;
+                            items[i].tooltip = InterpreterQuickPickList.condaEnvWithoutPythonTooltip;
                         }
                     }
                 });

src/client/interpreter/configuration/types.ts

@@ -52,11 +52,7 @@ export interface IInterpreterQuickPickItem extends QuickPickItem {
     interpreter: PythonEnvironment;
 }
 
-export interface ISpecialQuickPickItem {
-    label: string;
-    description?: string;
-    detail?: string;
-    alwaysShow: boolean;
+export interface ISpecialQuickPickItem extends QuickPickItem {
     path?: string;
 }
 

typings/vscode-proposed/vscode.proposed.quickPickItemTooltip.d.ts

@@ -0,0 +1,16 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/73904
+
+	export interface QuickPickItem {
+		/**
+		 * An optional flag to sort the final results by index of first query match in label. Defaults to true.
+		 */
+		tooltip?: string | MarkdownString;
+	}
+}