@codingame/monaco-vscode-api 34.1.2 → 35.0.0

package/vscode/src/vs/editor/contrib/colorPicker/browser/colorDetector.js

@@ -105,6 +105,7 @@ let ColorDetector = class ColorDetector extends Disposable {
     updateColors() {
         this.stop();
         if (!this._isColorDecoratorsEnabled) {
+            this.removeAllDecorations();
             return;
         }
         const model = this._editor.getModel();

package/vscode/src/vs/editor/contrib/colorPicker/browser/colorPickerParticipantUtils.d.ts

@@ -3,7 +3,7 @@ import { IActiveCodeEditor } from "../../../browser/editorBrowser.js";
 import { DocumentColorProvider, IColorInformation } from "../../../common/languages.js";
 import { ITextModel } from "../../../common/model.js";
 import { ColorPickerModel } from "./colorPickerModel.js";
-import { Range } from "../../../common/core/range.js";
+import { IRange, Range } from "../../../common/core/range.js";
 export declare enum ColorPickerWidgetType {
     Hover = "hover",
     Standalone = "standalone"
@@ -14,5 +14,5 @@ export interface BaseColor {
     readonly provider: DocumentColorProvider;
 }
 export declare function createColorHover(editorModel: ITextModel, colorInfo: IColorInformation, provider: DocumentColorProvider): Promise<BaseColor>;
-export declare function updateEditorModel(editor: IActiveCodeEditor, range: Range, model: ColorPickerModel): Range;
+export declare function updateEditorModel(editor: IActiveCodeEditor, range: Range, model: ColorPickerModel, insertionRanges?: IRange[]): Range;
 export declare function updateColorPresentations(editorModel: ITextModel, colorPickerModel: ColorPickerModel, color: Color, range: Range, colorHover: BaseColor): Promise<void>;

package/vscode/src/vs/editor/contrib/colorPicker/browser/colorPickerParticipantUtils.js

@@ -36,19 +36,27 @@ async function createColorHover(editorModel, colorInfo, provider) {
         provider
     };
 }
-function updateEditorModel(editor, range, model) {
+function updateEditorModel(editor, range, model, insertionRanges) {
     const textEdits = [];
     const edit = model.presentation.textEdit ?? {
         range,
         text: model.presentation.label,
         forceMoveMarkers: false
     };
-    textEdits.push(edit);
     if (model.presentation.additionalTextEdits) {
         textEdits.push(...model.presentation.additionalTextEdits);
     }
     const replaceRange = Range.lift(edit.range);
     const trackedRange = editor.getModel()._setTrackedRange(null, replaceRange, TrackedRangeStickiness.GrowsOnlyWhenTypingAfter);
+    if (insertionRanges) {
+        textEdits.push(...( insertionRanges.map(insertionRange => ({
+            range: insertionRange,
+            text: edit.text,
+            forceMoveMarkers: false
+        }))));
+    } else {
+        textEdits.push(edit);
+    }
     editor.executeEdits("colorpicker", textEdits);
     editor.pushUndoStop();
     return editor.getModel()._getTrackedRange(trackedRange) ?? replaceRange;

package/vscode/src/vs/editor/contrib/colorPicker/browser/standaloneColorPicker/standaloneColorPickerParticipant.d.ts

@@ -8,7 +8,7 @@ import { IEditorHoverRenderContext } from "../../../hover/browser/hoverTypes.js"
 import { ColorPickerModel } from "../colorPickerModel.js";
 import { BaseColor } from "../colorPickerParticipantUtils.js";
 import { ColorPickerWidget } from "../colorPickerWidget.js";
-import { Range } from "../../../../common/core/range.js";
+import { IRange, Range } from "../../../../common/core/range.js";
 export declare class StandaloneColorPickerHover implements BaseColor {
     readonly owner: StandaloneColorPickerParticipant;
     readonly range: Range;
@@ -32,7 +32,7 @@ export declare class StandaloneColorPickerParticipant {
         colorHover: StandaloneColorPickerHover;
         foundInEditor: boolean;
     } | null>;
-    updateEditorModel(colorHoverData: StandaloneColorPickerHover): Promise<void>;
+    updateEditorModel(colorHoverData: StandaloneColorPickerHover, insertionRanges?: IRange[]): Promise<void>;
     renderHoverParts(context: IEditorHoverRenderContext, hoverParts: StandaloneColorPickerHover[]): StandaloneColorPickerRenderedParts | undefined;
     private _setMinimumDimensions;
     private get _color();

package/vscode/src/vs/editor/contrib/colorPicker/browser/standaloneColorPicker/standaloneColorPickerParticipant.js

@@ -86,7 +86,7 @@ let StandaloneColorPickerParticipant = class StandaloneColorPickerParticipant {
             foundInEditor
         };
     }
-    async updateEditorModel(colorHoverData) {
+    async updateEditorModel(colorHoverData, insertionRanges) {
         if (!this._editor.hasModel()) {
             return;
         }
@@ -105,7 +105,7 @@ let StandaloneColorPickerParticipant = class StandaloneColorPickerParticipant {
                 range,
                 colorHoverData
             );
-            range = updateEditorModel(this._editor, range, colorPickerModel);
+            range = updateEditorModel(this._editor, range, colorPickerModel, insertionRanges);
         }
     }
     renderHoverParts(context, hoverParts) {

package/vscode/src/vs/editor/contrib/colorPicker/browser/standaloneColorPicker/standaloneColorPickerWidget.d.ts

@@ -27,6 +27,7 @@ export declare class StandaloneColorPickerWidget extends Disposable implements I
     private _body;
     private _colorHover;
     private _selectionSetInEditor;
+    private _selections;
     private readonly _onResult;
     readonly onResult: import("../../../../../base/common/event.js").Event<StandaloneColorPickerResult>;
     private readonly _renderedHoverParts;

package/vscode/src/vs/editor/contrib/colorPicker/browser/standaloneColorPicker/standaloneColorPickerWidget.js

@@ -65,6 +65,7 @@ let StandaloneColorPickerWidget = class StandaloneColorPickerWidget extends Disp
         this._standaloneColorPickerParticipant = _instantiationService.createInstance(StandaloneColorPickerParticipant, this._editor);
         this._position = this._editor._getViewModel()?.getPrimaryCursorState().modelState.position;
         const editorSelection = this._editor.getSelection();
+        this._selections = this._editor.getSelections() ?? [];
         const selection = editorSelection ? {
             startLineNumber: editorSelection.startLineNumber,
             startColumn: editorSelection.startColumn,
@@ -89,6 +90,7 @@ let StandaloneColorPickerWidget = class StandaloneColorPickerWidget extends Disp
             } else {
                 this._selectionSetInEditor = false;
             }
+            this._selections = this._editor.getSelections() ?? [];
         }));
         this._register(this._editor.onMouseMove(e => {
             const classList = e.target.element?.classList;
@@ -105,7 +107,7 @@ let StandaloneColorPickerWidget = class StandaloneColorPickerWidget extends Disp
     }
     updateEditor() {
         if (this._colorHover) {
-            this._standaloneColorPickerParticipant.updateEditorModel(this._colorHover);
+            this._standaloneColorPickerParticipant.updateEditorModel(this._colorHover, this._selections);
         }
     }
     getId() {

package/vscode/src/vs/editor/contrib/hover/browser/contentHoverController.js

@@ -114,7 +114,7 @@ let ContentHoverController = class ContentHoverController extends Disposable {
         return this._isMouseOnContentHoverWidget(mouseEvent) || this._isContentWidgetResizing() || isOnColorDecorator(mouseEvent);
     }
     _isMouseOnContentHoverWidget(mouseEvent) {
-        if (!this._contentWidget) {
+        if (!this._contentWidget || !this._contentWidget.getDomNode().isConnected) {
             return false;
         }
         return isMousePositionWithinElement(

package/vscode/src/vs/editor/contrib/hover/browser/contentHoverRendered.js

@@ -10,13 +10,12 @@ import { Position } from '../../../common/core/position.js';
 import { Range } from '../../../common/core/range.js';
 import { createDocumentFragment, addDisposableListener, EventType } from '../../../../base/browser/dom.js';
 import { MarkdownHoverParticipant } from './markdownHoverParticipant.js';
-import { HoverColorPickerParticipant } from '../../colorPicker/browser/hoverColorPicker/hoverColorPickerParticipant.js';
+import { ColorHover, HoverColorPickerParticipant } from '../../colorPicker/browser/hoverColorPicker/hoverColorPickerParticipant.js';
 import { localize } from '../../../../nls.js';
 import { InlayHintsHover } from '../../inlayHints/browser/inlayHintsHover.js';
 import { BugIndicatingError } from '../../../../base/common/errors.js';
 import { IHoverService } from '../../../../platform/hover/browser/hover.service.js';
 import { IClipboardService } from '../../../../platform/clipboard/common/clipboardService.service.js';
-import { MarkerHover } from './markerHoverParticipant.js';
 
 var RenderedContentHover_1, RenderedContentHoverParts_1;
 let RenderedContentHover = RenderedContentHover_1 = class RenderedContentHover extends Disposable {
@@ -166,6 +165,7 @@ let RenderedContentHoverParts = class RenderedContentHoverParts extends Disposab
         this._hoverService = _hoverService;
         this._clipboardService = _clipboardService;
         this._renderedParts = [];
+        this._perPartDisposables = ( new Map());
         this._focusedHoverPartIndex = -1;
         this._context = context;
         this._fragment = createDocumentFragment();
@@ -241,28 +241,37 @@ let RenderedContentHoverParts = class RenderedContentHoverParts extends Disposab
         return ( new RenderedStatusBar(fragment, statusBar));
     }
     _registerListenersOnRenderedParts() {
-        const disposables = ( new DisposableStore());
         this._renderedParts.forEach((renderedPart, index) => {
-            const element = renderedPart.hoverElement;
-            element.tabIndex = 0;
-            disposables.add(addDisposableListener(element, EventType.FOCUS_IN, event => {
-                event.stopPropagation();
-                this._focusedHoverPartIndex = index;
-            }));
-            disposables.add(addDisposableListener(element, EventType.FOCUS_OUT, event => {
-                event.stopPropagation();
-                this._focusedHoverPartIndex = -1;
-            }));
-            if (renderedPart.type === "hoverPart" && renderedPart.hoverPart instanceof MarkerHover) {
-                disposables.add(( new HoverCopyButton(
-                    element,
-                    () => renderedPart.participant.getAccessibleContent(renderedPart.hoverPart),
-                    this._clipboardService,
-                    this._hoverService
-                )));
+            this._createListenersForPart(index, renderedPart);
+        });
+        return toDisposable(() => {
+            for (const d of ( this._perPartDisposables.values())) {
+                d.dispose();
             }
+            this._perPartDisposables.clear();
         });
-        return disposables;
+    }
+    _createListenersForPart(index, renderedPart) {
+        const partDisposables = ( new DisposableStore());
+        const element = renderedPart.hoverElement;
+        element.tabIndex = 0;
+        partDisposables.add(addDisposableListener(element, EventType.FOCUS_IN, event => {
+            event.stopPropagation();
+            this._focusedHoverPartIndex = index;
+        }));
+        partDisposables.add(addDisposableListener(element, EventType.FOCUS_OUT, event => {
+            event.stopPropagation();
+            this._focusedHoverPartIndex = -1;
+        }));
+        if (renderedPart.type === "hoverPart" && !(renderedPart.hoverPart instanceof ColorHover) && !renderedPart.participant.hideCopyButton) {
+            partDisposables.add(( new HoverCopyButton(
+                element,
+                () => renderedPart.participant.getAccessibleContent(renderedPart.hoverPart),
+                this._clipboardService,
+                this._hoverService
+            )));
+        }
+        this._perPartDisposables.set(index, partDisposables);
     }
     _updateMarkdownAndColorParticipantInfo(participants) {
         const markdownHoverParticipant = participants.find(p => {
@@ -332,12 +341,18 @@ let RenderedContentHoverParts = class RenderedContentHoverParts extends Disposab
             if (!renderedPart) {
                 continue;
             }
+            const prevDisposable = this._perPartDisposables.get(i);
+            if (prevDisposable) {
+                prevDisposable.dispose();
+                this._perPartDisposables.delete(i);
+            }
             this._renderedParts[i] = {
                 type: "hoverPart",
                 participant: this._markdownHoverParticipant,
                 hoverPart: renderedPart.hoverPart,
                 hoverElement: renderedPart.hoverElement
             };
+            this._createListenersForPart(i, this._renderedParts[i]);
         }
         if (focus) {
             if (index >= 0) {

package/vscode/src/vs/editor/contrib/hover/browser/contentHoverWidgetWrapper.d.ts

@@ -38,6 +38,7 @@ export declare class ContentHoverWidgetWrapper extends Disposable implements IHo
     private _getHoverContext;
     showsOrWillShow(mouseEvent: IEditorMouseEvent): boolean;
     private _findHoverAnchorCandidates;
+    private _isMouseOnCodeActionWidget;
     private _onMouseLeave;
     startShowingAtRange(range: Range, mode: HoverStartMode, source: HoverStartSource, focus: boolean): void;
     getWidgetContent(): string | undefined;

package/vscode/src/vs/editor/contrib/hover/browser/contentHoverWidgetWrapper.js

@@ -232,6 +232,9 @@ let ContentHoverWidgetWrapper = class ContentHoverWidgetWrapper extends Disposab
         if (isContentWidgetResizing) {
             return true;
         }
+        if (this._isMouseOnCodeActionWidget(mouseEvent)) {
+            return true;
+        }
         const anchorCandidates = this._findHoverAnchorCandidates(mouseEvent);
         const anchorCandidatesExist = anchorCandidates.length > 0;
         if (!anchorCandidatesExist) {
@@ -273,6 +276,13 @@ let ContentHoverWidgetWrapper = class ContentHoverWidgetWrapper extends Disposab
         anchorCandidates.sort((a, b) => b.priority - a.priority);
         return anchorCandidates;
     }
+    _isMouseOnCodeActionWidget(mouseEvent) {
+        const target = mouseEvent.event.browserEvent.target;
+        if (target instanceof Element && !!target.closest(".action-widget")) {
+            return true;
+        }
+        return false;
+    }
     _onMouseLeave(e) {
         const editorDomNode = this._editor.getDomNode();
         const isMousePositionOutsideOfEditor = !editorDomNode || !isMousePositionWithinElement(editorDomNode, e.x, e.y);

package/vscode/src/vs/editor/contrib/hover/browser/hoverTypes.d.ts

@@ -128,6 +128,7 @@ export declare class RenderedHoverParts<T extends IHoverPart> implements IRender
 }
 export interface IEditorHoverParticipant<T extends IHoverPart = IHoverPart> {
     readonly hoverOrdinal: number;
+    readonly hideCopyButton?: boolean;
     suggestHoverAnchor?(mouseEvent: IEditorMouseEvent): HoverAnchor | null;
     computeSync(anchor: HoverAnchor, lineDecorations: IModelDecoration[], source: HoverStartSource): T[];
     computeAsync?(anchor: HoverAnchor, lineDecorations: IModelDecoration[], source: HoverStartSource, token: CancellationToken): AsyncIterable<T>;

package/vscode/src/vs/editor/contrib/hover/browser/markerHoverParticipant.js

@@ -106,7 +106,13 @@ let MarkerHoverParticipant = class MarkerHoverParticipant {
         return ( new RenderedHoverParts(renderedHoverParts, disposables));
     }
     getAccessibleContent(hoverPart) {
-        return hoverPart.marker.message;
+        const {
+            marker
+        } = hoverPart;
+        const relatedInformation = isNonEmptyArray(marker.relatedInformation) ? ( marker.relatedInformation.map(
+            related => `${basename(related.resource)}(${related.startLineNumber}, ${related.startColumn}): ${related.message}`
+        )).join("\n") : undefined;
+        return [marker.message, relatedInformation].filter(value => !!value).join("\n");
     }
     _renderMarkerHover(markerHover) {
         const disposables = ( new DisposableStore());
@@ -277,7 +283,6 @@ let MarkerHoverParticipant = class MarkerHoverParticipant {
                         showing = true;
                         const controller = CodeActionController.get(this._editor);
                         const elementPosition = getDomNodePagePosition(target);
-                        context.hide();
                         controller?.showCodeActions(markerCodeActionTrigger, actions, {
                             x: elementPosition.left,
                             y: elementPosition.top,

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/hintsWidget/hoverParticipant.d.ts

@@ -21,6 +21,7 @@ export declare class InlineCompletionsHoverParticipant implements IEditorHoverPa
     private readonly _telemetryService;
     private readonly _markdownRendererService;
     readonly hoverOrdinal: number;
+    readonly hideCopyButton: boolean;
     constructor(_editor: ICodeEditor, accessibilityService: IAccessibilityService, _instantiationService: IInstantiationService, _telemetryService: ITelemetryService, _markdownRendererService: IMarkdownRendererService);
     suggestHoverAnchor(mouseEvent: IEditorMouseEvent): HoverAnchor | null;
     computeSync(anchor: HoverAnchor, lineDecorations: IModelDecoration[]): InlineCompletionsHover[];

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/hintsWidget/hoverParticipant.js

@@ -43,6 +43,7 @@ let InlineCompletionsHoverParticipant = class InlineCompletionsHoverParticipant
         this._telemetryService = _telemetryService;
         this._markdownRendererService = _markdownRendererService;
         this.hoverOrdinal = 4;
+        this.hideCopyButton = true;
     }
     suggestHoverAnchor(mouseEvent) {
         const controller = InlineCompletionsController.get(this._editor);

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/hintsWidget/inlineCompletionsHintsWidget.css

@@ -27,6 +27,7 @@
 
 .monaco-editor .inlineSuggestionsHints .keybinding {
 	display: flex;
+	align-items: center;
 	margin-left: 4px;
 	opacity: 0.6;
 }
@@ -43,5 +44,6 @@
 }
 
 .monaco-editor .inlineSuggestionStatusBarItemLabel {
+	align-items: center;
 	margin-right: 2px;
 }

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/hintsWidget/inlineCompletionsHintsWidget.js

@@ -273,9 +273,7 @@ let InlineSuggestionHintsContentWidget = class InlineSuggestionHintsContentWidge
                 enabled: true,
                 tooltip: c.command.tooltip || "",
                 label: c.command.title,
-                run: event => {
-                    return this._commandService.executeCommand(c.command.id);
-                }
+                run: () => this._commandService.executeCommand(c.command.id, ...(c.command.arguments ?? []))
             })));
             for (const [_, group] of this.inlineCompletionsActionsMenus.getActions()) {
                 for (const action of group) {

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/model/suggestWidgetAdapter.js

@@ -12,7 +12,6 @@ import { SnippetParser } from '../../../snippet/browser/snippetParser.js';
 import { SnippetSession } from '../../../snippet/browser/snippetSession.js';
 import { SuggestController } from '../../../suggest/browser/suggestController.js';
 import '../../../../../base/common/observableInternal/index.js';
-import { EditorOption } from '../../../../common/config/editorOptions.js';
 import { observableFromEvent } from '../../../../../base/common/observableInternal/observables/observableFromEvent.js';
 
 class SuggestWidgetAdaptor extends Disposable {
@@ -125,10 +124,6 @@ class SuggestWidgetAdaptor extends Disposable {
         if (!suggestController || !this.isSuggestWidgetVisible) {
             return undefined;
         }
-        const quickSuggestions = this.editor.getOption(EditorOption.quickSuggestions);
-        if (typeof quickSuggestions === "object" && (quickSuggestions.other === "offWhenInlineCompletions" || quickSuggestions.comments === "offWhenInlineCompletions" || quickSuggestions.strings === "offWhenInlineCompletions")) {
-            return undefined;
-        }
         const focusedItem = suggestController.widget.value.getFocusedItem();
         const position = this.editor.getPosition();
         const model = this.editor.getModel();

package/vscode/src/vs/editor/contrib/insertFinalNewLine/browser/insertFinalNewLineCommand.js

@@ -1,5 +1,4 @@
 
-import { lastNonWhitespaceIndex } from '../../../../base/common/strings.js';
 import { EditOperation } from '../../../common/core/editOperation.js';
 import { Position } from '../../../common/core/position.js';
 
@@ -21,11 +20,6 @@ class InsertFinalNewLineCommand {
 }
 function insertFinalNewLine(model) {
     const lineCount = model.getLineCount();
-    const lastLine = model.getLineContent(lineCount);
-    const lastLineIsEmptyOrWhitespace = lastNonWhitespaceIndex(lastLine) === -1;
-    if (!lineCount || lastLineIsEmptyOrWhitespace) {
-        return;
-    }
     return EditOperation.insert(( new Position(lineCount, model.getLineMaxColumn(lineCount))), model.getEOL());
 }
 

package/vscode/src/vs/editor/contrib/stickyScroll/browser/stickyScrollWidget.js

@@ -145,7 +145,11 @@ class StickyScrollWidget extends Disposable {
         }
         let totalHeight = 0;
         for (let i = 0; i < candidateLineNumbers.length; i++) {
-            totalHeight += this._editor.getLineHeightForPosition(( new Position(candidateLineNumbers[i], 1)));
+            const position = ( new Position(candidateLineNumbers[i], 1));
+            const viewModel = this._editor._getViewModel();
+            if (viewModel && position.lineNumber <= viewModel.getLineCount()) {
+                totalHeight += this._editor.getLineHeightForPosition(( new Position(candidateLineNumbers[i], 1)));
+            }
         }
         if (totalHeight === 0) {
             return {

package/vscode/src/vs/editor/contrib/suggest/browser/media/suggest.css

@@ -179,10 +179,14 @@
 	opacity: 1;
 }
 
-/** signature, qualifier, type/details opacity **/
+/** signature, qualifier, type/details styling **/
 
 .monaco-editor .suggest-widget .monaco-list .monaco-list-row > .contents > .main > .right > .details-label {
-	opacity: 0.7;
+	color: var(--vscode-editorSuggestWidget-foreground);
+}
+
+.monaco-editor .suggest-widget .monaco-list .monaco-list-row.focused > .contents > .main > .right > .details-label {
+	color: var(--vscode-editorSuggestWidget-selectedForeground);
 }
 
 .monaco-editor .suggest-widget .monaco-list .monaco-list-row > .contents > .main > .left > .signature-label {

package/vscode/src/vs/editor/standalone/browser/standaloneServices.js

@@ -1018,6 +1018,7 @@ class StandaloneDefaultAccountService {
         this.onDidChangeCopilotTokenInfo = Event.None;
         this.managedSettingsFetchStatus = null;
         this.managedSettingsFetchedAt = null;
+        this.managedSettingsRawResponse = null;
     }
     async getDefaultAccount() {
         return null;

package/vscode/src/vs/platform/accessibility/browser/accessibleView.d.ts

@@ -37,7 +37,10 @@ export declare enum AccessibleViewProviderId {
     WebviewFindHelp = "webviewFindHelp",
     OutputFindHelp = "outputFindHelp",
     ProblemsFilterHelp = "problemsFilterHelp",
-    SessionsChat = "sessionsChat"
+    SessionsChat = "sessionsChat",
+    SessionsChanges = "sessionsChanges",
+    Survey = "survey",
+    Automations = "automations"
 }
 export declare enum AccessibleViewType {
     Help = "help",

package/vscode/src/vs/platform/accessibility/browser/accessibleView.js

@@ -36,6 +36,9 @@ var AccessibleViewProviderId;
     AccessibleViewProviderId["OutputFindHelp"] = "outputFindHelp";
     AccessibleViewProviderId["ProblemsFilterHelp"] = "problemsFilterHelp";
     AccessibleViewProviderId["SessionsChat"] = "sessionsChat";
+    AccessibleViewProviderId["SessionsChanges"] = "sessionsChanges";
+    AccessibleViewProviderId["Survey"] = "survey";
+    AccessibleViewProviderId["Automations"] = "automations";
 })(AccessibleViewProviderId || (AccessibleViewProviderId = {}));
 var AccessibleViewType;
 (function (AccessibleViewType) {

package/vscode/src/vs/platform/actionWidget/browser/actionList.d.ts

@@ -38,6 +38,21 @@ export interface IActionListItemHover {
      */
     readonly disposable?: IDisposable;
 }
+/**
+ * Optional inline toggle switch rendered inside an action list item, shown on its
+ * own row below the label/detail. Useful for an always-visible boolean sub-control
+ * (e.g. a sandbox toggle) that is independent from selecting the item itself.
+ */
+export interface IActionListItemInlineToggle {
+    /** Label shown to the left of the switch. */
+    readonly label: string;
+    /** Current checked state of the switch. */
+    readonly checked: boolean;
+    /** Invoked when the user flips the switch. */
+    readonly onChange: (checked: boolean) => void;
+    /** Optional accessible/hover title for the switch. Defaults to {@link label}. */
+    readonly title?: string;
+}
 export interface IActionListItem<T> {
     readonly item?: T;
     readonly kind: ActionListItemKind;
@@ -52,6 +67,10 @@ export interface IActionListItem<T> {
      * Optional detail text displayed as a second line below the label.
      */
     readonly detail?: string;
+    /**
+     * Optional inline toggle switch rendered on its own row inside the item.
+     */
+    readonly inlineToggle?: IActionListItemInlineToggle;
     readonly description?: string | IMarkdownString;
     /**
      * Optional accessible description used in place of {@link description} for
@@ -111,6 +130,15 @@ export declare enum ActionListItemKind {
     Header = "header",
     Separator = "separator"
 }
+/**
+ * A "Learn more" style link rendered inline in the action list header banner.
+ */
+export interface IActionListHeaderLink {
+    /** Visible link text (e.g. "Learn more"). Should be localized. */
+    readonly label: string;
+    /** Target opened via the opener service when the link is activated. */
+    readonly uri: URI;
+}
 /**
  * Options for configuring the action list.
  */
@@ -159,6 +187,11 @@ export interface IActionListOptions {
      * Defaults to 48.
      */
     readonly detailItemHeight?: number;
+    /**
+     * Height (in px) used for action items that have an `inlineToggle`.
+     * Defaults to 70.
+     */
+    readonly inlineToggleItemHeight?: number;
     /**
      * When true, the group title is shown on the first item of each group
      * in the description area (aligned to the right).
@@ -187,6 +220,23 @@ export interface IActionListOptions {
      * Optional text shown below the action list as a footer.
      */
     readonly footerText?: string;
+    /**
+     * Optional text shown above the action list as a header banner. When set, it is
+     * rendered at the top of the widget, optionally prefixed by {@link headerIcon}.
+     */
+    readonly headerText?: string;
+    /**
+     * Optional icon shown to the left of {@link headerText} in the header banner.
+     */
+    readonly headerIcon?: ThemeIcon;
+    /** Optional "Learn more" link rendered inline after {@link headerText}, opened via the opener service. */
+    readonly headerLink?: IActionListHeaderLink;
+    /** Optional dismiss ("x") button on the header banner; invoked on click, and the banner is removed. */
+    readonly headerDismiss?: () => void;
+    /**
+     * Optional CSS class name added to the action list container, for scoped styling.
+     */
+    readonly className?: string;
 }
 /**
  * A standalone action list widget that handles core list rendering, filtering,
@@ -194,6 +244,7 @@ export interface IActionListOptions {
  * or anchor-based positioning. Suitable for embedding directly in any container.
  */
 export declare class ActionListWidget<T> extends Disposable {
+    protected readonly _supportsPreview: boolean;
     protected readonly _delegate: IActionListDelegate<T>;
     protected readonly _options: IActionListOptions | undefined;
     private readonly _keybindingService;
@@ -219,6 +270,7 @@ export declare class ActionListWidget<T> extends Disposable {
     private readonly _filterInput;
     private readonly _filterContainer;
     private readonly _footerContainer;
+    private _headerContainer;
     private readonly _filterCts;
     private readonly _groupTitleByIndex;
     private readonly _onDidRequestLayout;
@@ -227,7 +279,7 @@ export declare class ActionListWidget<T> extends Disposable {
      * re-layout (e.g. after filtering or collapsing a section).
      */
     readonly onDidRequestLayout: import("../../../base/common/event.js").Event<void>;
-    constructor(user: string, preview: boolean, items: readonly IActionListItem<T>[], _delegate: IActionListDelegate<T>, accessibilityProvider: Partial<IListAccessibilityProvider<IActionListItem<T>>> | undefined, _options: IActionListOptions | undefined, _keybindingService: IKeybindingService, _openerService: IOpenerService, _instantiationService: IInstantiationService);
+    constructor(user: string, _supportsPreview: boolean, items: readonly IActionListItem<T>[], _delegate: IActionListDelegate<T>, accessibilityProvider: Partial<IListAccessibilityProvider<IActionListItem<T>>> | undefined, _options: IActionListOptions | undefined, _keybindingService: IKeybindingService, _openerService: IOpenerService, _instantiationService: IInstantiationService);
     private _toggleSection;
     private _applyOrUpdateFilter;
     private _applyFilter;
@@ -237,11 +289,25 @@ export declare class ActionListWidget<T> extends Disposable {
      */
     get filterContainer(): HTMLElement | undefined;
     get footerContainer(): HTMLElement | undefined;
+    get headerContainer(): HTMLElement | undefined;
     get filterInput(): HTMLInputElement | undefined;
     private focusCondition;
     focus(): void;
     clearFocus(): void;
     getFocusedElement(): IActionListItem<T> | undefined;
+    /**
+     * Replaces the items in the list in place, preserving the current filter,
+     * without closing or repositioning the widget. When {@link focusItemId} is
+     * provided, that item ({@link IActionListItem.item}'s `id`) is focused;
+     * otherwise the previously focused item is preserved (matched by id).
+     */
+    updateItems(items: readonly IActionListItem<T>[], focusItemId?: string): void;
+    /**
+     * Focuses the item whose {@link IActionListItem.item}'s `id` matches
+     * {@link itemId}, without rebuilding the list. Re-applies the focus after the
+     * current event so a mouse click's own pointer handling cannot reset it.
+     */
+    focusItemById(itemId: string): void;
     private _focusCheckedOrFirst;
     hide(didCancel?: boolean): void;
     clearFilter(): boolean;
@@ -288,6 +354,13 @@ export declare class ActionListWidget<T> extends Disposable {
     private _showSubmenuForItem;
     private _showSubmenuForElement;
     private _hideSubmenu;
+    /**
+     * Clears the submenu/hover panel. If focus currently lives inside the panel
+     * (e.g. the user clicked a button in the hover content), focus is first moved
+     * back to the list. Otherwise clearing the panel would drop focus to <body>,
+     * which blurs the action widget and dismisses it.
+     */
+    private _clearSubmenuContainer;
     private _scheduleSubmenuHide;
     private _cancelSubmenuHide;
     private _scheduleSubmenuShow;
@@ -311,6 +384,7 @@ export declare class ActionList<T> extends Disposable {
     get domNode(): HTMLElement;
     get filterContainer(): HTMLElement | undefined;
     get footerContainer(): HTMLElement | undefined;
+    get headerContainer(): HTMLElement | undefined;
     get filterInput(): HTMLInputElement | undefined;
     /**
      * Returns the resolved anchor position after the first layout.
@@ -327,6 +401,8 @@ export declare class ActionList<T> extends Disposable {
     expandFocusedSection(): void;
     toggleFocusedSection(): boolean;
     acceptSelected(preview?: boolean): void;
+    updateItems(items: readonly IActionListItem<T>[], focusItemId?: string): void;
+    focusItemById(itemId: string): void;
     private hasDynamicHeight;
     private computeActionWidgetVerticalChromeHeight;
     private computeHeight;