@codingame/monaco-vscode-accessibility-service-override 37.2.0 → 37.3.1

package/index.js

@@ -13,6 +13,7 @@ import { AccessibilityService } from '@codingame/monaco-vscode-api/vscode/vs/pla
 import { registerAssets } from '@codingame/monaco-vscode-api/assets';
 import './vscode/src/vs/workbench/contrib/accessibility/browser/accessibility.contribution.js';
 import './vscode/src/vs/workbench/contrib/codeEditor/browser/accessibility/accessibility.js';
+import './vscode/src/vs/workbench/contrib/codeEditor/browser/editorFindAccessibilityHelp.js';
 import './vscode/src/vs/workbench/contrib/accessibilitySignals/browser/accessibilitySignal.contribution.js';
 
 registerAssets(audioAssets);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-accessibility-service-override",
-  "version": "37.2.0",
+  "version": "37.3.1",
   "private": false,
   "description": "VSCode public API plugged on the monaco editor - accessibility service-override",
   "keywords": [],
@@ -15,7 +15,7 @@
   },
   "type": "module",
   "dependencies": {
-    "@codingame/monaco-vscode-api": "37.2.0",
+    "@codingame/monaco-vscode-api": "37.3.1",
     "marked": "14.0.0"
   },
   "main": "index.js",

package/vscode/src/vs/workbench/contrib/accessibility/browser/accessibilityStatus.js

@@ -53,21 +53,21 @@ let AccessibilityStatus = class AccessibilityStatus extends Disposable {
     }
     showScreenReaderNotification() {
         this.screenReaderNotification = this.notificationService.prompt(Severity.Info, ( localize(
-            5056,
+            7028,
             "Screen reader usage detected. Do you want to enable {0} to optimize the editor for screen reader usage?",
             "editor.accessibilitySupport"
         )), [{
-            label: ( localize(5057, "Yes")),
+            label: ( localize(7029, "Yes")),
             run: () => {
                 this.configurationService.updateValue("editor.accessibilitySupport", "on", ConfigurationTarget.USER);
             }
         }, {
-            label: ( localize(5058, "No")),
+            label: ( localize(7030, "No")),
             run: () => {
                 this.configurationService.updateValue("editor.accessibilitySupport", "off", ConfigurationTarget.USER);
             }
         }, {
-            label: ( localize(5059, "Learn More")),
+            label: ( localize(7031, "Learn More")),
             run: () => {
                 this.openerService.open("https://code.visualstudio.com/docs/editor/accessibility#_screen-readers");
             }
@@ -80,9 +80,9 @@ let AccessibilityStatus = class AccessibilityStatus extends Disposable {
     updateScreenReaderModeElement(visible) {
         if (visible) {
             if (!this.screenReaderModeElement.value) {
-                const text = ( localize(5060, "Screen Reader Optimized"));
+                const text = ( localize(7032, "Screen Reader Optimized"));
                 this.screenReaderModeElement.value = this.statusbarService.addEntry({
-                    name: ( localize(5061, "Screen Reader Mode")),
+                    name: ( localize(7033, "Screen Reader Mode")),
                     text,
                     ariaLabel: text,
                     command: "showEditorScreenReaderNotification",

package/vscode/src/vs/workbench/contrib/accessibility/browser/accessibleView.d.ts

@@ -18,7 +18,7 @@ import { IOpenerService } from "@codingame/monaco-vscode-api/vscode/vs/platform/
 import { IQuickInputService } from "@codingame/monaco-vscode-api/vscode/vs/platform/quickinput/common/quickInput.service";
 import { IStorageService } from "@codingame/monaco-vscode-api/vscode/vs/platform/storage/common/storage.service";
 import { IChatCodeBlockContextProviderService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chat.service";
-import { ICodeBlockActionContext } from "@codingame/monaco-vscode-katex-common/vscode/vs/workbench/contrib/chat/browser/widget/chatContentParts/codeBlockPart";
+import { ICodeBlockActionContext } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/widget/chatContentParts/codeBlockPart";
 import { AccessibilityVerbositySettingId } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/accessibility/browser/accessibilityConfiguration";
 export type AccesibleViewContentProvider = AccessibleContentProvider | ExtensionContentProvider;
 export declare class AccessibleView extends Disposable {

package/vscode/src/vs/workbench/contrib/accessibility/browser/accessibleView.js

@@ -474,8 +474,8 @@ let AccessibleView = class AccessibleView extends Disposable {
         const disposables = this._register(( new DisposableStore()));
         const quickPick = disposables.add(this._quickInputService.createQuickPick());
         quickPick.items = items;
-        quickPick.title = ( localize(5062, "Configure keybindings"));
-        quickPick.placeholder = ( localize(5063, "Select a command ID to configure a keybinding for it"));
+        quickPick.title = ( localize(7034, "Configure keybindings"));
+        quickPick.placeholder = ( localize(7035, "Select a command ID to configure a keybinding for it"));
         quickPick.show();
         disposables.add(quickPick.onDidAccept(async () => {
             const item = quickPick.selectedItems[0];
@@ -510,7 +510,7 @@ let AccessibleView = class AccessibleView extends Disposable {
                             break;
                         }
                         firstListItem = `- ${firstItem.text}`;
-                        label = ( token.items.map(i => i.text)).join(", ");
+                        label = token.items.map(i => i.text).join(", ");
                         break;
                     }
                 }
@@ -518,8 +518,8 @@ let AccessibleView = class AccessibleView extends Disposable {
             if (label) {
                 symbols.push({
                     markdownToParse: label,
-                    label: ( localize(5064, "({0}) {1}", token.type, label)),
-                    ariaLabel: ( localize(5065, "({0}) {1}", token.type, label)),
+                    label: ( localize(7036, "({0}) {1}", token.type, label)),
+                    ariaLabel: ( localize(7037, "({0}) {1}", token.type, label)),
                     firstListItem
                 });
                 firstListItem = undefined;
@@ -559,7 +559,7 @@ let AccessibleView = class AccessibleView extends Disposable {
         }
         this._configurationService.updateValue(this._currentProvider?.verbositySettingKey, false);
         alert(( localize(
-            5066,
+            7038,
             "{0} accessibility verbosity is now disabled",
             this._currentProvider.verbositySettingKey
         )));
@@ -654,16 +654,16 @@ let AccessibleView = class AccessibleView extends Disposable {
             const hasActions = this._accessibleViewSupportsNavigation.get() || this._accessibleViewVerbosityEnabled.get() || this._accessibleViewGoToSymbolSupported.get() || provider.actions?.length;
             if (verbose && !showAccessibleViewHelp && hasActions) {
                 actionsHint = provider.options.position ? ( localize(
-                    5067,
+                    7039,
                     "Explore actions such as disabling this hint (Shift+Tab), use Escape to exit this dialog."
-                )) : ( localize(5068, "Explore actions such as disabling this hint (Shift+Tab)."));
+                )) : ( localize(7040, "Explore actions such as disabling this hint (Shift+Tab)."));
             }
-            let ariaLabel = provider.options.type === AccessibleViewType.Help ? ( localize(5069, "Accessibility Help")) : ( localize(5070, "Accessible View"));
+            let ariaLabel = provider.options.type === AccessibleViewType.Help ? ( localize(7041, "Accessibility Help")) : ( localize(7042, "Accessible View"));
             this._title.textContent = ariaLabel;
             if (actionsHint && provider.options.type === AccessibleViewType.View) {
-                ariaLabel = ( localize(5071, "Accessible View, {0}", actionsHint));
+                ariaLabel = ( localize(7043, "Accessible View, {0}", actionsHint));
             } else if (actionsHint) {
-                ariaLabel = ( localize(5072, "Accessibility Help, {0}", actionsHint));
+                ariaLabel = ( localize(7044, "Accessibility Help, {0}", actionsHint));
             }
             if (isWindows && widgetIsFocused) {
                 ariaLabel = "";
@@ -767,7 +767,7 @@ let AccessibleView = class AccessibleView extends Disposable {
         return disposableStore;
     }
     _updateToolbar(providedActions, type) {
-        this._toolbar.setAriaLabel(type === AccessibleViewType.Help ? ( localize(5073, "Accessibility Help")) : ( localize(5074, "Accessible View")));
+        this._toolbar.setAriaLabel(type === AccessibleViewType.Help ? ( localize(7045, "Accessibility Help")) : ( localize(7046, "Accessible View")));
         const toolbarMenu = this._menuService.createMenu(MenuId.AccessibleView, this._contextKeyService);
         this._toolbarMenu.value = toolbarMenu;
         const menuActions = getFlatActionBarActions(toolbarMenu.getActions({}));
@@ -864,9 +864,9 @@ let AccessibleView = class AccessibleView extends Disposable {
     _accessibleViewHelpDialogContent(providerHasSymbols) {
         const navigationHint = this._navigationHint();
         const goToSymbolHint = this._goToSymbolHint(providerHasSymbols);
-        const toolbarHint = ( localize(5075, "Navigate to the toolbar (Shift+Tab)."));
+        const toolbarHint = ( localize(7047, "Navigate to the toolbar (Shift+Tab)."));
         const chatHints = this._getChatHints();
-        let hint = ( localize(5076, "In the accessible view, you can:\n"));
+        let hint = ( localize(7048, "In the accessible view, you can:\n"));
         if (navigationHint) {
             hint += " - " + navigationHint + "\n";
         }
@@ -886,22 +886,22 @@ let AccessibleView = class AccessibleView extends Disposable {
             return;
         }
         return [( localize(
-            5077,
+            7049,
             " - Insert the code block at the cursor{0}.",
             "<keybinding:workbench.action.chat.insertCodeBlock>"
         )), ( localize(
-            5078,
+            7050,
             " - Insert the code block into a new file{0}.",
             "<keybinding:workbench.action.chat.insertIntoNewFile>"
         )), ( localize(
-            5079,
+            7051,
             " - Run the code block in the terminal{0}.\n",
             "<keybinding:workbench.action.chat.runInTerminal>"
         ))].join("\n");
     }
     _navigationHint() {
         return localize(
-            5080,
+            7052,
             "Show the next item{0} or previous item{1}.",
             `<keybinding:${AccessibilityCommandId.ShowNext}>`,
             `<keybinding:${AccessibilityCommandId.ShowPrevious}>`
@@ -910,7 +910,7 @@ let AccessibleView = class AccessibleView extends Disposable {
     _disableVerbosityHint(provider) {
         if (provider.options.type === AccessibleViewType.Help && this._verbosityEnabled()) {
             return localize(
-                5081,
+                7053,
                 "\nDisable accessibility verbosity for this feature{0}.",
                 `<keybinding:${AccessibilityCommandId.DisableVerbosityHint}>`
             );
@@ -922,7 +922,7 @@ let AccessibleView = class AccessibleView extends Disposable {
             return;
         }
         return localize(
-            5082,
+            7054,
             "Go to a symbol{0}.",
             `<keybinding:${AccessibilityCommandId.GoToSymbol}>`
         );
@@ -931,7 +931,7 @@ let AccessibleView = class AccessibleView extends Disposable {
         const configureKb = this._keybindingService.lookupKeybinding(AccessibilityCommandId.AccessibilityHelpConfigureKeybindings)?.getAriaLabel();
         const keybindingToConfigureQuickPick = configureKb ? "(" + configureKb + ")" : "by assigning a keybinding to the command Accessibility Help Configure Unassigned Keybindings.";
         return localize(
-            5083,
+            7055,
             "\nConfigure keybindings for commands that lack them {0}.",
             keybindingToConfigureQuickPick
         );
@@ -940,7 +940,7 @@ let AccessibleView = class AccessibleView extends Disposable {
         const configureKb = this._keybindingService.lookupKeybinding(AccessibilityCommandId.AccessibilityHelpConfigureAssignedKeybindings)?.getAriaLabel();
         const keybindingToConfigureQuickPick = configureKb ? "(" + configureKb + ")" : "by assigning a keybinding to the command Accessibility Help Configure Assigned Keybindings.";
         return localize(
-            5084,
+            7056,
             "\nConfigure keybindings for commands that already have assignments {0}.",
             keybindingToConfigureQuickPick
         );
@@ -959,11 +959,11 @@ let AccessibleView = class AccessibleView extends Disposable {
         return screenReaderModeHint;
     }
     _exitDialogHint(provider) {
-        return this._verbosityEnabled() && !provider.options.position ? ( localize(5085, "\nExit this dialog (Escape).")) : "";
+        return this._verbosityEnabled() && !provider.options.position ? ( localize(7057, "\nExit this dialog (Escape).")) : "";
     }
     _readMoreHint(provider) {
         return provider.options.readMoreUrl ? ( localize(
-            5086,
+            7058,
             "\nOpen a browser window with more information related to accessibility{0}.",
             `<keybinding:${AccessibilityCommandId.AccessibilityHelpOpenHelpLink}>`
         )) : "";
@@ -1008,10 +1008,10 @@ let AccessibleViewService = class AccessibleViewService extends Disposable {
         const keybinding = this._keybindingService.lookupKeybinding(AccessibilityCommandId.OpenAccessibleView)?.getAriaLabel();
         let hint = null;
         if (keybinding) {
-            hint = ( localize(5087, "Inspect this in the accessible view with {0}", keybinding));
+            hint = ( localize(7059, "Inspect this in the accessible view with {0}", keybinding));
         } else {
             hint = ( localize(
-                5088,
+                7060,
                 "Inspect this in the accessible view via the command Open Accessible View which is currently not triggerable via keybinding."
             ));
         }
@@ -1049,8 +1049,8 @@ let AccessibleViewSymbolQuickPick = class AccessibleViewSymbolQuickPick {
     show(provider) {
         const disposables = ( new DisposableStore());
         const quickPick = disposables.add(this._quickInputService.createQuickPick());
-        quickPick.placeholder = ( localize(5089, "Type to search symbols"));
-        quickPick.title = ( localize(5090, "Go to Symbol Accessible View"));
+        quickPick.placeholder = ( localize(7061, "Type to search symbols"));
+        quickPick.title = ( localize(7062, "Go to Symbol Accessible View"));
         const picks = [];
         const symbols = this._accessibleView.getSymbols();
         if (!symbols) {

package/vscode/src/vs/workbench/contrib/accessibilitySignals/browser/commands.js

@@ -18,11 +18,11 @@ class ShowSignalSoundHelp extends Action2 {
     constructor() {
         super({
             id: ShowSignalSoundHelp.ID,
-            title: ( localize2(5103, "Help: List Signal Sounds")),
+            title: ( localize2(7075, "Help: List Signal Sounds")),
             f1: true,
             metadata: {
                 description: ( localize(
-                    5104,
+                    7076,
                     "List all accessibility sounds, noises, or audio cues and configure their settings"
                 ))
             }
@@ -35,15 +35,15 @@ class ShowSignalSoundHelp extends Action2 {
         const accessibilityService = accessor.get(IAccessibilityService);
         const preferencesService = accessor.get(IPreferencesService);
         const userGestureSignals = [AccessibilitySignal.save, AccessibilitySignal.format];
-        const items = ( AccessibilitySignal.allAccessibilitySignals.map((signal, idx) => ({
+        const items = AccessibilitySignal.allAccessibilitySignals.map((signal, idx) => ({
             label: userGestureSignals.includes(signal) ? `${signal.name} (${configurationService.getValue(signal.settingsKey + ".sound")})` : signal.name,
             signal,
             buttons: userGestureSignals.includes(signal) ? [{
                 iconClass: ThemeIcon.asClassName(Codicon.settingsGear),
-                tooltip: ( localize(5105, "Configure Sound")),
+                tooltip: ( localize(7077, "Configure Sound")),
                 alwaysVisible: true
             }] : []
-        }))).sort((a, b) => a.label.localeCompare(b.label));
+        })).sort((a, b) => a.label.localeCompare(b.label));
         const disposables = ( new DisposableStore());
         const qp = disposables.add(quickInputService.createQuickPick());
         qp.items = items;
@@ -51,8 +51,8 @@ class ShowSignalSoundHelp extends Action2 {
             i => accessibilitySignalService.isSoundEnabled(i.signal) || userGestureSignals.includes(i.signal) && configurationService.getValue(i.signal.settingsKey + ".sound") !== "never"
         );
         disposables.add(qp.onDidAccept(() => {
-            const enabledSounds = ( qp.selectedItems.map(i => i.signal));
-            const disabledSounds = ( qp.items.map(i => i.signal)).filter(i => !enabledSounds.includes(i));
+            const enabledSounds = qp.selectedItems.map(i => i.signal);
+            const disabledSounds = qp.items.map(i => i.signal).filter(i => !enabledSounds.includes(i));
             for (const signal of enabledSounds) {
                 let {
                     sound,
@@ -103,7 +103,7 @@ class ShowSignalSoundHelp extends Action2 {
             );
         }));
         disposables.add(qp.onDidHide(() => disposables.dispose()));
-        qp.placeholder = ( localize(5106, "Select a sound to play and configure"));
+        qp.placeholder = ( localize(7078, "Select a sound to play and configure"));
         qp.canSelectMany = true;
         await qp.show();
     }
@@ -118,11 +118,11 @@ class ShowAccessibilityAnnouncementHelp extends Action2 {
     constructor() {
         super({
             id: ShowAccessibilityAnnouncementHelp.ID,
-            title: ( localize2(5107, "Help: List Signal Announcements")),
+            title: ( localize2(7079, "Help: List Signal Announcements")),
             f1: true,
             metadata: {
                 description: ( localize(
-                    5108,
+                    7080,
                     "List all accessibility announcements, alerts, braille messages, and configure their settings"
                 ))
             }
@@ -135,15 +135,15 @@ class ShowAccessibilityAnnouncementHelp extends Action2 {
         const accessibilityService = accessor.get(IAccessibilityService);
         const preferencesService = accessor.get(IPreferencesService);
         const userGestureSignals = [AccessibilitySignal.save, AccessibilitySignal.format];
-        const items = ( AccessibilitySignal.allAccessibilitySignals.filter(c => !!c.legacyAnnouncementSettingsKey).map((signal, idx) => ({
+        const items = AccessibilitySignal.allAccessibilitySignals.filter(c => !!c.legacyAnnouncementSettingsKey).map((signal, idx) => ({
             label: userGestureSignals.includes(signal) ? `${signal.name} (${configurationService.getValue(signal.settingsKey + ".announcement")})` : signal.name,
             signal,
             buttons: userGestureSignals.includes(signal) ? [{
                 iconClass: ThemeIcon.asClassName(Codicon.settingsGear),
-                tooltip: ( localize(5109, "Configure Announcement")),
+                tooltip: ( localize(7081, "Configure Announcement")),
                 alwaysVisible: true
             }] : []
-        }))).sort((a, b) => a.label.localeCompare(b.label));
+        })).sort((a, b) => a.label.localeCompare(b.label));
         const disposables = ( new DisposableStore());
         const qp = disposables.add(quickInputService.createQuickPick());
         qp.items = items;
@@ -156,7 +156,7 @@ class ShowAccessibilityAnnouncementHelp extends Action2 {
                 qp.hide();
                 return;
             }
-            const enabledAnnouncements = ( qp.selectedItems.map(i => i.signal));
+            const enabledAnnouncements = qp.selectedItems.map(i => i.signal);
             const disabledAnnouncements = AccessibilitySignal.allAccessibilitySignals.filter(
                 cue => !!cue.legacyAnnouncementSettingsKey && !enabledAnnouncements.includes(cue)
             );
@@ -194,8 +194,8 @@ class ShowAccessibilityAnnouncementHelp extends Action2 {
             });
         }));
         disposables.add(qp.onDidHide(() => disposables.dispose()));
-        qp.placeholder = screenReaderOptimized ? ( localize(5110, "Select an announcement to configure")) : ( localize(
-            5111,
+        qp.placeholder = screenReaderOptimized ? ( localize(7082, "Select an announcement to configure")) : ( localize(
+            7083,
             "Screen reader is not active, announcements are disabled by default."
         ));
         qp.canSelectMany = true;

package/vscode/src/vs/workbench/contrib/accessibilitySignals/browser/editorTextPropertySignalsContribution.js

@@ -63,10 +63,10 @@ let EditorTextPropertySignalsContribution = class EditorTextPropertySignalsContr
         let lastLine = -1;
         const ignoredLineSignalsForCurrentLine = ( new Set());
         const timeouts = store.add(( new DisposableStore()));
-        const propertySources = ( this._textProperties.map(p => ({
+        const propertySources = this._textProperties.map(p => ({
             source: p.createSource(editor, editorModel),
             property: p
-        })));
+        }));
         const didType = wasEventTriggeredRecently(editor.onDidChangeModelContent, 100, store);
         store.add(editor.onDidChangeCursorPosition(args => {
             timeouts.clear();

package/vscode/src/vs/workbench/contrib/accessibilitySignals/browser/openDiffEditorAnnouncement.js

@@ -41,7 +41,7 @@ let DiffEditorActiveAnnouncementContribution = class DiffEditorActiveAnnouncemen
         }
         this._onDidActiveEditorChangeListener = this._register(this._editorService.onDidActiveEditorChange(() => {
             if (isDiffEditor(this._editorService.activeTextEditorControl)) {
-                this._accessibilityService.alert(( localize(5112, "Diff editor")));
+                this._accessibilityService.alert(( localize(7084, "Diff editor")));
             }
         }));
     }

package/vscode/src/vs/workbench/contrib/codeEditor/browser/accessibility/accessibility.js

@@ -17,15 +17,15 @@ import { CursorColumns } from '@codingame/monaco-vscode-api/vscode/vs/editor/com
 import { EditorContextKeys } from '@codingame/monaco-vscode-api/vscode/vs/editor/common/editorContextKeys';
 import { ContextKeyExpr } from '@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey';
 
-registerCss(accessibility);
+registerCss(accessibility, 1);
 class ToggleScreenReaderMode extends Action2 {
     constructor() {
         super({
             id: "editor.action.toggleScreenReaderAccessibilityMode",
-            title: ( localize2(10976, "Toggle Screen Reader Accessibility Mode")),
+            title: ( localize2(12975, "Toggle Screen Reader Accessibility Mode")),
             metadata: {
                 description: ( localize2(
-                    10977,
+                    12976,
                     "Toggles an optimized mode for usage with screen readers, braille devices, and other assistive technologies."
                 ))
             },
@@ -62,11 +62,11 @@ class AnnounceCursorPosition extends Action2 {
     constructor() {
         super({
             id: "editor.action.announceCursorPosition",
-            title: ( localize2(10978, "Announce Cursor Position")),
+            title: ( localize2(12977, "Announce Cursor Position")),
             f1: true,
             metadata: {
                 description: ( localize2(
-                    10979,
+                    12978,
                     "Announce the current cursor position (line and column) via screen reader."
                 ))
             },
@@ -91,7 +91,7 @@ class AnnounceCursorPosition extends Action2 {
         const tabSize = model.getOptions().tabSize;
         const lineContent = model.getLineContent(position.lineNumber);
         const visibleColumn = CursorColumns.visibleColumnFromColumn(lineContent, position.column, tabSize) + 1;
-        alert(( localize(10980, "Line {0}, Column {1}", position.lineNumber, visibleColumn)));
+        alert(( localize(12979, "Line {0}, Column {1}", position.lineNumber, visibleColumn)));
     }
 }
 registerAction2(AnnounceCursorPosition);

package/vscode/src/vs/workbench/contrib/codeEditor/browser/editorFindAccessibilityHelp.d.ts

@@ -0,0 +1,75 @@
+import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { CommonFindController } from "@codingame/monaco-vscode-api/vscode/vs/editor/contrib/find/browser/findController";
+import { AccessibleViewProviderId, AccessibleViewType, IAccessibleViewContentProvider, IAccessibleViewOptions } from "@codingame/monaco-vscode-api/vscode/vs/platform/accessibility/browser/accessibleView";
+import { IAccessibleViewImplementation } from "@codingame/monaco-vscode-api/vscode/vs/platform/accessibility/browser/accessibleViewRegistry";
+import { ServicesAccessor } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+import { AccessibilityVerbositySettingId } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/accessibility/browser/accessibilityConfiguration";
+/**
+ * Accessible view implementation for Find and Replace help in the code editor.
+ * Provides comprehensive accessibility support for the Find dialog, including:
+ * - Search status information (current term, match count, position)
+ * - Navigation instructions for keyboard control
+ * - Focus behavior explanation
+ * - Available settings and options
+ * - Platform-specific guidance
+ *
+ * Activated via Alt+F1 when any element in the Find widget is focused.
+ */
+export declare class EditorFindAccessibilityHelp implements IAccessibleViewImplementation {
+    readonly priority = 105;
+    readonly name = "editor-find";
+    readonly when: import("@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey").RawContextKey<boolean>;
+    readonly type = AccessibleViewType.Help;
+    /**
+     * Creates an accessible view content provider for the active code editor's Find/Replace dialog.
+     * @param accessor Service accessor for retrieving the code editor service
+     * @returns The provider instance, or undefined if no active editor or find controller is found
+     */
+    getProvider(accessor: ServicesAccessor): EditorFindAccessibilityHelpProvider | undefined;
+}
+/**
+ * Content provider for the Find and Replace accessibility help.
+ * Generates localized, context-aware help information based on the current Find state.
+ *
+ * The implementation:
+ * - Adapts content based on whether Replace mode is active
+ * - Provides current search status (term, match count, position)
+ * - Explains focus behavior (how focus moves between Find input, Replace input, and editor)
+ * - Lists keyboard navigation shortcuts for different contexts
+ * - Documents available Find and Replace options
+ * - References relevant settings that affect Find behavior
+ * - Includes platform-specific guidance where applicable
+ */
+declare class EditorFindAccessibilityHelpProvider extends Disposable implements IAccessibleViewContentProvider {
+    private readonly _findController;
+    readonly id = AccessibleViewProviderId.EditorFindHelp;
+    readonly verbositySettingKey = AccessibilityVerbositySettingId.Find;
+    readonly options: IAccessibleViewOptions;
+    constructor(_findController: CommonFindController);
+    /**
+     * Returns focus to the last focused element in the Find widget when the accessibility help is closed.
+     * This handles focus restoration for any element (inputs, checkboxes, buttons) not just the text inputs.
+     */
+    onClose(): void;
+    /**
+     * Generates the complete accessibility help content for Find and Replace.
+     * The content structure varies based on whether Replace mode is visible:
+     *
+     * Replace Mode Content:
+     * - Header identifying the dialog
+     * - Context explaining what the dialog does
+     * - Current search and replace status
+     * - Focus behavior explanation
+     * - Keyboard shortcuts for Find, Replace, and Editor contexts
+     * - Find and Replace options explanation
+     * - Configurable settings documentation
+     * - Platform-specific settings (macOS)
+     *
+     * Find-Only Mode Content:
+     * - Similar structure but without Replace-specific sections
+     *
+     * @returns The complete help text as a newline-joined string for audio announcement
+     */
+    provideContent(): string;
+}
+export {};

package/vscode/src/vs/workbench/contrib/codeEditor/browser/editorFindAccessibilityHelp.js

@@ -0,0 +1,442 @@
+
+import { Disposable } from '@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle';
+import { isMacintosh } from '@codingame/monaco-vscode-api/vscode/vs/base/common/platform';
+import { ICodeEditorService } from '@codingame/monaco-vscode-api/vscode/vs/editor/browser/services/codeEditorService.service';
+import { CommonFindController } from '@codingame/monaco-vscode-api/vscode/vs/editor/contrib/find/browser/findController';
+import { CONTEXT_FIND_WIDGET_FOCUSED } from '@codingame/monaco-vscode-api/vscode/vs/editor/contrib/find/browser/findModel';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { AccessibleViewType, AccessibleViewProviderId } from '@codingame/monaco-vscode-api/vscode/vs/platform/accessibility/browser/accessibleView';
+import { AccessibleViewRegistry } from '@codingame/monaco-vscode-api/vscode/vs/platform/accessibility/browser/accessibleViewRegistry';
+import { AccessibilityVerbositySettingId } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/accessibility/browser/accessibilityConfiguration';
+
+class EditorFindAccessibilityHelp {
+    constructor() {
+        this.priority = 105;
+        this.name = "editor-find";
+        this.when = CONTEXT_FIND_WIDGET_FOCUSED;
+        this.type = AccessibleViewType.Help;
+    }
+    getProvider(accessor) {
+        const codeEditorService = accessor.get(ICodeEditorService);
+        const codeEditor = codeEditorService.getActiveCodeEditor() || codeEditorService.getFocusedCodeEditor();
+        if (!codeEditor) {
+            return;
+        }
+        const findController = CommonFindController.get(codeEditor);
+        if (!findController) {
+            return;
+        }
+        return ( new EditorFindAccessibilityHelpProvider(findController));
+    }
+}
+class EditorFindAccessibilityHelpProvider extends Disposable {
+    constructor(_findController) {
+        super();
+        this._findController = _findController;
+        this.id = AccessibleViewProviderId.EditorFindHelp;
+        this.verbositySettingKey = AccessibilityVerbositySettingId.Find;
+        this.options = {
+            type: AccessibleViewType.Help
+        };
+    }
+    onClose() {
+        this._findController.focusLastElement();
+    }
+    provideContent() {
+        const state = this._findController.getState();
+        const isReplaceVisible = state.isReplaceRevealed;
+        const searchString = state.searchString;
+        const matchCount = state.matchesCount;
+        const matchPosition = state.matchesPosition;
+        const content = [];
+        if (isReplaceVisible) {
+            content.push(( localize(12994, "Accessibility Help: Editor Find and Replace")));
+            content.push(( localize(
+                12995,
+                "You are in the Find and Replace dialog for the active editor. This dialog lets you locate text and replace it. The editor is a separate surface that shows each match and the surrounding context."
+            )));
+            content.push("");
+            content.push(( localize(12996, "Current Search Status:")));
+            if (searchString) {
+                content.push(( localize(12997, "You are searching for: \"{0}\".", searchString)));
+                if (matchCount !== undefined && matchPosition !== undefined) {
+                    if (matchCount === 0) {
+                        content.push(( localize(
+                            12998,
+                            "No matches found in the current file. Try adjusting your search text or the options below."
+                        )));
+                    } else {
+                        content.push(( localize(12999, "Match {0} of {1}.", matchPosition, matchCount)));
+                    }
+                }
+            } else {
+                content.push(( localize(
+                    13000,
+                    "No search text entered yet. Start typing to find matches in the editor."
+                )));
+            }
+            const replaceString = state.replaceString;
+            if (replaceString) {
+                content.push(( localize(13001, "Replacement text: \"{0}\".", replaceString)));
+            } else {
+                content.push(( localize(
+                    13002,
+                    "No replacement text entered yet. Press Tab to move to the Replace input and type your replacement."
+                )));
+            }
+            content.push("");
+            content.push(( localize(13003, "Inside the Find and Replace Dialog (What It Does):")));
+            content.push(( localize(
+                13004,
+                "While you are in either input, your focus stays in that input. You can type, edit, or navigate matches without leaving. When you navigate to a match from the Find input, the editor updates in the background, but your focus remains in the dialog. Tab moves you from Find to Replace and back."
+            )));
+            content.push("");
+            content.push(( localize(13005, "What You Hear Each Time You Move to a Match:")));
+            content.push(( localize(13006, "Each navigation step gives you a complete spoken update:")));
+            content.push(( localize(
+                13007,
+                "1) The full line that contains the match is read first, so you get immediate context."
+            )));
+            content.push(( localize(
+                13008,
+                "2) Your position among the matches is announced, so you know how far you are through the results."
+            )));
+            content.push(( localize(
+                13009,
+                "3) The exact line and column are announced, so you know precisely where the match is in the file."
+            )));
+            content.push("");
+            content.push(( localize(13010, "Focus Behavior (Important):")));
+            content.push(( localize(
+                13011,
+                "When you navigate from inside the Find dialog, the editor updates while your focus stays in the input. This is intentional, so you can keep adjusting your search without losing your place."
+            )));
+            content.push(( localize(
+                13012,
+                "When you replace from the Replace input, the match is replaced and focus moves to the next match. If you have replaced all matches, the dialog remains open."
+            )));
+            content.push(( localize(
+                13013,
+                "If you want to move focus into the editor to edit text, press Escape to close the dialog. Focus returns to the editor at the last replacement location."
+            )));
+            content.push("");
+            content.push(( localize(13014, "Keyboard Navigation Summary:")));
+            content.push("");
+            content.push(( localize(13015, "While focused IN the Find input:")));
+            content.push(( localize(13016, "- Enter: Move to the next match while staying in Find.")));
+            content.push(( localize(13017, "- Shift+Enter: Move to the previous match while staying in Find.")));
+            content.push(( localize(13018, "- Tab: Move between Find and Replace inputs.")));
+            content.push("");
+            content.push(( localize(13019, "While focused IN the Replace input:")));
+            content.push(( localize(13020, "- Enter: Replace the current match and move to the next.")));
+            content.push(( localize(
+                13021,
+                "- {0}: Replace only the current match.",
+                "<keybinding:editor.action.replaceOne>"
+            )));
+            content.push(( localize(
+                13022,
+                "- {0}: Replace all matches at once.",
+                "<keybinding:editor.action.replaceAll>"
+            )));
+            content.push("");
+            content.push(( localize(13023, "While focused IN the editor (not the Find input):")));
+            content.push(( localize(
+                13024,
+                "- {0}: Move to the next match.",
+                "<keybinding:editor.action.nextMatchFindAction>"
+            )));
+            content.push(( localize(
+                13025,
+                "- {0}: Move to the previous match.",
+                "<keybinding:editor.action.previousMatchFindAction>"
+            )));
+            content.push("");
+            content.push(( localize(
+                13026,
+                "Note: Don't press Enter or Shift+Enter when focused in the editor - these will insert line breaks instead of navigating."
+            )));
+            content.push("");
+            content.push(( localize(13027, "Find and Replace Options in the Dialog:")));
+            content.push(( localize(13028, "- Match Case: Only exact case matches are included.")));
+            content.push(( localize(13029, "- Whole Word: Only full words are matched.")));
+            content.push(( localize(13030, "- Regular Expression: Use pattern matching for advanced searches.")));
+            content.push(( localize(13031, "- Find in Selection: Limit matches to the current selection.")));
+            content.push(( localize(
+                13032,
+                "- Preserve Case: When replacing, maintains the case of the original match."
+            )));
+            content.push("");
+            content.push(( localize(
+                13033,
+                "Settings You Can Adjust ({0} opens Settings):",
+                "<keybinding:workbench.action.openSettings>"
+            )));
+            content.push(( localize(
+                13034,
+                "These settings affect how Find and Replace behave or how matches are highlighted."
+            )));
+            content.push(( localize(
+                13035,
+                "- `accessibility.verbosity.find`: Controls whether the Find and Replace inputs announce the Accessibility Help hint."
+            )));
+            content.push(( localize(13036, "- `editor.find.findOnType`: Runs Find as you type.")));
+            content.push(( localize(
+                13037,
+                "- `editor.find.cursorMoveOnType`: Moves the cursor to the best match while you type."
+            )));
+            content.push(( localize(
+                13038,
+                "- `editor.find.seedSearchStringFromSelection`: Controls when selection text is used to seed Find."
+            )));
+            content.push(( localize(
+                13039,
+                "- `editor.find.autoFindInSelection`: Automatically enables Find in Selection based on selection type."
+            )));
+            content.push(( localize(
+                13040,
+                "- `editor.find.loop`: Wraps search at the beginning or end of the file."
+            )));
+            content.push(( localize(
+                13041,
+                "- `editor.find.addExtraSpaceOnTop`: Adds extra scroll space so matches are not hidden behind the Find and Replace dialog."
+            )));
+            content.push(( localize(
+                13042,
+                "- `editor.find.history`: Controls whether Find search history is stored."
+            )));
+            content.push(( localize(
+                13043,
+                "- `editor.find.replaceHistory`: Controls whether Replace history is stored."
+            )));
+            content.push(( localize(
+                13044,
+                "- `editor.occurrencesHighlight`: Highlights other occurrences of the current symbol."
+            )));
+            content.push(( localize(
+                13045,
+                "- `editor.occurrencesHighlightDelay`: Controls how soon occurrences are highlighted."
+            )));
+            content.push(( localize(
+                13046,
+                "- `editor.selectionHighlight`: Highlights other matches of the current selection."
+            )));
+            content.push(( localize(
+                13047,
+                "- `editor.selectionHighlightMaxLength`: Limits selection highlight length."
+            )));
+            content.push(( localize(
+                13048,
+                "- `editor.selectionHighlightMultiline`: Controls whether multi-line selections are highlighted."
+            )));
+            if (isMacintosh) {
+                content.push("");
+                content.push(( localize(13049, "Platform-Specific Setting (macOS only):")));
+                content.push(( localize(
+                    13050,
+                    "- `editor.find.globalFindClipboard`: Uses the shared macOS Find clipboard when available."
+                )));
+            }
+            content.push("");
+            content.push(( localize(13051, "Closing:")));
+            content.push(( localize(
+                13052,
+                "Press Escape to close Find and Replace. Focus returns to the editor at the last replacement location, and your search and replace history is preserved."
+            )));
+        } else {
+            content.push(( localize(13053, "Accessibility Help: Editor Find")));
+            content.push(( localize(
+                13054,
+                "You are in the Find dialog for the active editor. This dialog is where you type what you want to locate. The editor is a separate surface that shows each match and its surrounding context."
+            )));
+            content.push("");
+            content.push(( localize(13055, "Current Search Status:")));
+            if (searchString) {
+                content.push(( localize(13056, "You are searching for: \"{0}\".", searchString)));
+                if (matchCount !== undefined && matchPosition !== undefined) {
+                    if (matchCount === 0) {
+                        content.push(( localize(
+                            13057,
+                            "No matches found in the current file. Try adjusting your search text or the options below."
+                        )));
+                    } else {
+                        content.push(( localize(13058, "Match {0} of {1}.", matchPosition, matchCount)));
+                    }
+                }
+            } else {
+                content.push(( localize(
+                    13059,
+                    "No search text entered yet. Start typing to find matches in the editor."
+                )));
+            }
+            content.push("");
+            content.push(( localize(13060, "Inside the Find Dialog (What It Does):")));
+            content.push(( localize(
+                13061,
+                "While you are in the Find dialog, your focus stays in the input. You can keep typing, edit your search text, or move through matches without leaving the dialog. When you navigate to a match from here, the editor updates in the background, but your focus remains in the Find dialog."
+            )));
+            content.push("");
+            content.push(( localize(13062, "What You Hear Each Time You Move to a Match:")));
+            content.push(( localize(
+                13063,
+                "Each navigation step gives you a complete spoken update so you always know where you are. The order is consistent:"
+            )));
+            content.push(( localize(
+                13064,
+                "1) The full line that contains the match is read first, so you get immediate context."
+            )));
+            content.push(( localize(
+                13065,
+                "2) Your position among the matches is announced, so you know how far you are through the results."
+            )));
+            content.push(( localize(
+                13066,
+                "3) The exact line and column are announced, so you know precisely where the match is in the file."
+            )));
+            content.push(( localize(13067, "This sequence happens every time you move forward or backward.")));
+            content.push("");
+            content.push(( localize(13068, "Outside the Find Dialog (Inside the Editor):")));
+            content.push(( localize(
+                13069,
+                "When you are focused in the editor instead of the Find dialog, you can still navigate matches."
+            )));
+            content.push(( localize(
+                13070,
+                "- Press {0} to move to the next match.",
+                "<keybinding:editor.action.nextMatchFindAction>"
+            )));
+            content.push(( localize(
+                13071,
+                "- Press {0} to move to the previous match.",
+                "<keybinding:editor.action.previousMatchFindAction>"
+            )));
+            content.push(( localize(
+                13072,
+                "You hear the same three-step sequence: full line, match position, then line and column."
+            )));
+            content.push("");
+            content.push(( localize(13073, "Focus Behavior (Important):")));
+            content.push(( localize(
+                13074,
+                "When you navigate from inside the Find dialog, the editor updates while your focus stays in the input. This is intentional, so you can keep adjusting your search without losing your place."
+            )));
+            content.push(( localize(
+                13075,
+                "If you want to move focus into the editor to edit text or inspect surrounding code, press Escape to close Find. Focus returns to the editor at the most recent match."
+            )));
+            content.push("");
+            content.push(( localize(13076, "Keyboard Navigation Summary:")));
+            content.push("");
+            content.push(( localize(13077, "While focused IN the Find input:")));
+            content.push(( localize(13078, "- Enter: Move to the next match while staying in the Find dialog.")));
+            content.push(( localize(
+                13079,
+                "- Shift+Enter: Move to the previous match while staying in the Find dialog."
+            )));
+            content.push("");
+            content.push(( localize(13080, "While focused IN the editor (not the Find input):")));
+            content.push(( localize(
+                13081,
+                "- {0}: Move to the next match.",
+                "<keybinding:editor.action.nextMatchFindAction>"
+            )));
+            content.push(( localize(
+                13082,
+                "- {0}: Move to the previous match.",
+                "<keybinding:editor.action.previousMatchFindAction>"
+            )));
+            content.push("");
+            content.push(( localize(
+                13083,
+                "Note: Don't press Enter or Shift+Enter when focused in the editor - these will insert line breaks instead of navigating."
+            )));
+            content.push("");
+            content.push(( localize(13084, "Find Options in the Dialog:")));
+            content.push(( localize(13085, "- Match Case: Only exact case matches are included.")));
+            content.push(( localize(13086, "- Whole Word: Only full words are matched.")));
+            content.push(( localize(13087, "- Regular Expression: Use pattern matching for advanced searches.")));
+            content.push(( localize(13088, "- Find in Selection: Limit matches to the current selection.")));
+            content.push("");
+            content.push(( localize(
+                13089,
+                "Settings You Can Adjust ({0} opens Settings):",
+                "<keybinding:workbench.action.openSettings>"
+            )));
+            content.push(( localize(
+                13090,
+                "These settings affect how Find behaves or how matches are highlighted."
+            )));
+            content.push(( localize(
+                13091,
+                "- `accessibility.verbosity.find`: Controls whether the Find input announces the Accessibility Help hint."
+            )));
+            content.push(( localize(13092, "- `editor.find.findOnType`: Runs Find as you type.")));
+            content.push(( localize(
+                13093,
+                "- `editor.find.cursorMoveOnType`: Moves the cursor to the best match while you type."
+            )));
+            content.push(( localize(
+                13094,
+                "- `editor.find.seedSearchStringFromSelection`: Controls when selection text is used to seed Find."
+            )));
+            content.push(( localize(
+                13095,
+                "- `editor.find.autoFindInSelection`: Automatically enables Find in Selection based on selection type."
+            )));
+            content.push(( localize(
+                13096,
+                "- `editor.find.loop`: Wraps search at the beginning or end of the file."
+            )));
+            content.push(( localize(
+                13097,
+                "- `editor.find.closeOnResult`: Closes the Find dialog after an explicit find navigation command lands on a match."
+            )));
+            content.push(( localize(
+                13098,
+                "- `editor.find.addExtraSpaceOnTop`: Adds extra scroll space so matches are not hidden behind the Find dialog."
+            )));
+            content.push(( localize(
+                13099,
+                "- `editor.find.history`: Controls whether Find search history is stored."
+            )));
+            content.push(( localize(
+                13100,
+                "- `editor.occurrencesHighlight`: Highlights other occurrences of the current symbol."
+            )));
+            content.push(( localize(
+                13101,
+                "- `editor.occurrencesHighlightDelay`: Controls how soon occurrences are highlighted."
+            )));
+            content.push(( localize(
+                13102,
+                "- `editor.selectionHighlight`: Highlights other matches of the current selection."
+            )));
+            content.push(( localize(
+                13103,
+                "- `editor.selectionHighlightMaxLength`: Limits selection highlight length."
+            )));
+            content.push(( localize(
+                13104,
+                "- `editor.selectionHighlightMultiline`: Controls whether multi-line selections are highlighted."
+            )));
+            if (isMacintosh) {
+                content.push("");
+                content.push(( localize(13105, "Platform-Specific Setting (macOS only):")));
+                content.push(( localize(
+                    13106,
+                    "- `editor.find.globalFindClipboard`: Uses the shared macOS Find clipboard when available."
+                )));
+            }
+            content.push("");
+            content.push(( localize(13107, "Closing:")));
+            content.push(( localize(
+                13108,
+                "Press Escape to close Find. Focus returns to the editor at the most recent match, and your search history is preserved."
+            )));
+        }
+        return content.join("\n");
+    }
+}
+AccessibleViewRegistry.register(( new EditorFindAccessibilityHelp()));
+
+export { EditorFindAccessibilityHelp };