From fad423f3e58de16ecbfbd862a48d98b8cbd096d2 Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Tue, 14 Jul 2026 13:24:33 -0600
Subject: [PATCH] Add "Show Help at Cursor" to the editor context menu

---
 .../browser/positronHelpActions.ts            | 37 ++++++++++++++++++-
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/src/vs/workbench/contrib/positronHelp/browser/positronHelpActions.ts b/src/vs/workbench/contrib/positronHelp/browser/positronHelpActions.ts
index 12f73c8c3135..d091cc3bfbbc 100644
--- a/src/vs/workbench/contrib/positronHelp/browser/positronHelpActions.ts
+++ b/src/vs/workbench/contrib/positronHelp/browser/positronHelpActions.ts
@@ -10,7 +10,7 @@ import { IEditor } from '../../../../editor/common/editorCommon.js';
 import { ITextModel } from '../../../../editor/common/model.js';
 import { ILanguageFeaturesService } from '../../../../editor/common/services/languageFeatures.js';
 import { CancellationToken } from '../../../../base/common/cancellation.js';
-import { Action2 } from '../../../../platform/actions/common/actions.js';
+import { Action2, MenuId } from '../../../../platform/actions/common/actions.js';
 import { KeyChord, KeyCode, KeyMod } from '../../../../base/common/keyCodes.js';
 import { ServicesAccessor } from '../../../../platform/instantiation/common/instantiation.js';
 import { IPositronHelpService } from './positronHelpService.js';
@@ -23,6 +23,7 @@ import { PositronConsoleFocused } from '../../../common/contextkeys.js';
 import { ContextKeyExpr } from '../../../../platform/contextkey/common/contextkey.js';
 import { IPositronConsoleService } from '../../../services/positronConsole/browser/interfaces/positronConsoleService.js';
 import { IRuntimeSessionService } from '../../../services/runtimeSession/common/runtimeSessionService.js';
+import { POSITRON_RUNTIME_LANGUAGE_IDS } from '../../languageRuntime/browser/languageRuntimeContextKeys.js';
 
 export class ShowHelpAtCursor extends Action2 {
 	constructor() {
@@ -41,7 +42,39 @@ export class ShowHelpAtCursor extends Action2 {
 				when: ContextKeyExpr.or(EditorContextKeys.focus, PositronConsoleFocused)
 			},
 			category: Categories.Help,
-			f1: true
+			f1: true,
+			menu: [
+				{
+					id: MenuId.EditorContext,
+					// Show on editors whose language has a registered Positron
+					// runtime. The list is maintained dynamically by
+					// PositronRuntimeLanguagesContextKeyContribution so new
+					// runtimes are picked up without code changes here.
+					//
+					// Quarto is added explicitly: a .qmd document's outer
+					// language is 'quarto', but the command still works
+					// because it resolves the embedded language at the
+					// cursor via getLanguageIdAtPosition.
+					when: ContextKeyExpr.and(
+						EditorContextKeys.editorTextFocus,
+						ContextKeyExpr.or(
+							ContextKeyExpr.in(
+								EditorContextKeys.languageId.key,
+								POSITRON_RUNTIME_LANGUAGE_IDS.key,
+							),
+							ContextKeyExpr.equals(
+								EditorContextKeys.languageId.key,
+								'quarto',
+							),
+						),
+					),
+					// Sit just below "Go to References" (order 1.45) and just
+					// above "View Data Frame at Cursor" (order 1.5) in the
+					// editor context menu's navigation group.
+					group: 'navigation',
+					order: 1.47,
+				},
+			],
 		});
 	}