Add miscellaneous file open notifications

Author: JoeRobich

l10n/bundle.l10n.json

@@ -172,6 +172,10 @@
   "C# configuration has changed. Would you like to reload the window to apply your changes?": "C# configuration has changed. Would you like to reload the window to apply your changes?",
   "Nested Code Action": "Nested Code Action",
   "Fix All: ": "Fix All: ",
+  "{0} is not part of the open workspace. Not all language features will be available.": "{0} is not part of the open workspace. Not all language features will be available.",
+  "Dismiss": "Dismiss",
+  "Do not show for this workspace": "Do not show for this workspace",
+  "Do not show again": "Do not show again",
   "Open solution": "Open solution",
   "Restart server": "Restart server",
   "C# Workspace Status": "C# Workspace Status",

src/lsptoolshost/languageStatusBar.ts

@@ -11,18 +11,11 @@ import { ServerState } from './serverStateChange';
 import { getCSharpDevKit } from '../utils/getCSharpDevKit';
 import { RazorLanguage } from '../razor/src/razorLanguage';
 
-let currentServerState: ServerState = ServerState.Stopped;
-
 export function registerLanguageStatusItems(
     context: vscode.ExtensionContext,
     languageServer: RoslynLanguageServer,
     languageServerEvents: RoslynLanguageServerEvents
 ) {
-    // Track the current server state.
-    languageServerEvents.onServerStateChange((e) => {
-        currentServerState = e.state;
-    });
-
     // DevKit will provide an equivalent workspace status item.
     if (!getCSharpDevKit()) {
         WorkspaceStatus.createStatusItem(context, languageServerEvents);
@@ -85,7 +78,7 @@ class ProjectContextStatus {
 
             // Show a warning when the active file is part of the Miscellaneous File workspace and
             // project initialization is complete.
-            if (currentServerState === ServerState.ProjectInitializationComplete) {
+            if (languageServer.state === ServerState.ProjectInitializationComplete) {
                 item.severity = e.context._vs_is_miscellaneous
                     ? vscode.LanguageStatusSeverity.Warning
                     : vscode.LanguageStatusSeverity.Information;

src/lsptoolshost/miscellaneousFileNotifier.ts

@@ -0,0 +1,65 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import * as vscode from 'vscode';
+import { RoslynLanguageServer } from './roslynLanguageServer';
+import { ActionOption, showWarningMessage } from '../shared/observers/utils/showMessage';
+import { ServerState } from './serverStateChange';
+import path = require('path');
+
+const NotifyMiscellaneousFilesOption = 'dotnet.miscellaneousFilesNotification.enabled';
+const RecentlyNotifiedDocuments = new Set<vscode.Uri>();
+const CooldownTime = 60 * 1000;
+
+export function registerMiscellaneousFileNotifier(
+    context: vscode.ExtensionContext,
+    languageServer: RoslynLanguageServer
+) {
+    context.workspaceState.update(NotifyMiscellaneousFilesOption, undefined);
+    context.globalState.update(NotifyMiscellaneousFilesOption, undefined);
+
+    languageServer._projectContextService.onActiveFileContextChanged((e) => {
+        if (RecentlyNotifiedDocuments.has(e.uri)) {
+            return;
+        }
+
+        if (!e.context._vs_is_miscellaneous || languageServer.state !== ServerState.ProjectInitializationComplete) {
+            return;
+        }
+
+        if (!context.globalState.get<boolean>(NotifyMiscellaneousFilesOption, true)) {
+            return;
+        }
+
+        if (!context.workspaceState.get<boolean>(NotifyMiscellaneousFilesOption, true)) {
+            return;
+        }
+
+        RecentlyNotifiedDocuments.add(e.uri);
+
+        const message = vscode.l10n.t(
+            '{0} is not part of the open workspace. Not all language features will be available.',
+            path.basename(e.uri.fsPath)
+        );
+        const dismissItem = vscode.l10n.t('Dismiss');
+        const disableWorkspace: ActionOption = {
+            title: vscode.l10n.t('Do not show for this workspace'),
+            action: async () => {
+                context.workspaceState.update(NotifyMiscellaneousFilesOption, false);
+            },
+        };
+        const disableGlobal: ActionOption = {
+            title: vscode.l10n.t('Do not show again'),
+            action: async () => {
+                context.globalState.update(NotifyMiscellaneousFilesOption, false);
+            },
+        };
+        showWarningMessage(vscode, message, disableWorkspace, disableGlobal, dismissItem);
+
+        setTimeout(() => {
+            RecentlyNotifiedDocuments.delete(e.uri);
+        }, CooldownTime);
+    });
+}

src/lsptoolshost/roslynLanguageServer.ts

@@ -75,6 +75,7 @@ import {
     showInformationMessage,
 } from '../shared/observers/utils/showMessage';
 import { registerSourceGeneratedFilesContentProvider } from './sourceGeneratedFilesContentProvider';
+import { registerMiscellaneousFileNotifier } from './miscellaneousFileNotifier';
 
 let _channel: vscode.OutputChannel;
 let _traceChannel: vscode.OutputChannel;
@@ -115,8 +116,10 @@ export class RoslynLanguageServer {
 
     public readonly _onAutoInsertFeature: OnAutoInsertFeature;
 
-    public _buildDiagnosticService: BuildDiagnosticsService;
-    public _projectContextService: ProjectContextService;
+    public readonly _buildDiagnosticService: BuildDiagnosticsService;
+    public readonly _projectContextService: ProjectContextService;
+
+    private _state: ServerState = ServerState.Stopped;
 
     constructor(
         private _languageClient: RoslynLanguageClient,
@@ -129,6 +132,7 @@ export class RoslynLanguageServer {
         this.registerSendOpenSolution();
         this.registerProjectInitialization();
         this.registerServerStateChanged();
+        this.registerServerStateTracking();
         this.registerReportProjectConfiguration();
         this.registerExtensionsChanged();
         this.registerTelemetryChanged();
@@ -151,6 +155,10 @@ export class RoslynLanguageServer {
         this._onAutoInsertFeature = new OnAutoInsertFeature(this._languageClient);
     }
 
+    public get state(): ServerState {
+        return this._state;
+    }
+
     private registerSetTrace() {
         // Set the language client trace level based on the log level option.
         // setTrace only works after the client is already running.
@@ -179,6 +187,12 @@ export class RoslynLanguageServer {
         });
     }
 
+    private registerServerStateTracking() {
+        this._languageServerEvents.onServerStateChange((e) => {
+            this._state = e.state;
+        });
+    }
+
     private registerSendOpenSolution() {
         this._languageClient.onDidChangeState(async (state) => {
             if (state.newState === State.Running) {
@@ -1053,6 +1067,7 @@ export async function activateRoslynLanguageServer(
     );
 
     registerLanguageStatusItems(context, languageServer, languageServerEvents);
+    registerMiscellaneousFileNotifier(context, languageServer);
     registerCopilotExtension(languageServer, _channel);
 
     // Register any commands that need to be handled by the extension.