@codingame/monaco-vscode-api 1.85.0 → 1.85.1

package/vscode/src/vs/workbench/contrib/snippets/browser/commands/fileTemplateSnippets.js

@@ -0,0 +1,95 @@
+import { isFalsyOrEmpty, groupBy } from 'monaco-editor/esm/vs/base/common/arrays.js';
+import { compare } from 'monaco-editor/esm/vs/base/common/strings.js';
+import { getCodeEditor } from 'monaco-editor/esm/vs/editor/browser/editorBrowser.js';
+import { ILanguageService } from 'monaco-editor/esm/vs/editor/common/languages/language.js';
+import { SnippetController2 } from 'monaco-editor/esm/vs/editor/contrib/snippet/browser/snippetController2.js';
+import { localizeWithPath } from 'monaco-editor/esm/vs/nls.js';
+import { IQuickInputService } from 'monaco-editor/esm/vs/platform/quickinput/common/quickInput.js';
+import { SnippetsAction } from './abstractSnippetsActions.js';
+import { ISnippetsService } from '../snippets.js';
+import { IEditorService } from '../../../../services/editor/common/editorService.js';
+class ApplyFileSnippetAction extends SnippetsAction {
+    static { this.Id = 'workbench.action.populateFileFromSnippet'; }
+    constructor() {
+        super({
+            id: ApplyFileSnippetAction.Id,
+            title: {
+                value: ( localizeWithPath(
+                    'vs/workbench/contrib/snippets/browser/commands/fileTemplateSnippets',
+                    'label',
+                    'Fill File with Snippet'
+                )),
+                original: 'Fill File with Snippet'
+            },
+            f1: true,
+        });
+    }
+    async run(accessor) {
+        const snippetService = accessor.get(ISnippetsService);
+        const quickInputService = accessor.get(IQuickInputService);
+        const editorService = accessor.get(IEditorService);
+        const langService = accessor.get(ILanguageService);
+        const editor = getCodeEditor(editorService.activeTextEditorControl);
+        if (!editor || !editor.hasModel()) {
+            return;
+        }
+        const snippets = await snippetService.getSnippets(undefined, { fileTemplateSnippets: true, noRecencySort: true, includeNoPrefixSnippets: true });
+        if (snippets.length === 0) {
+            return;
+        }
+        const selection = await this._pick(quickInputService, langService, snippets);
+        if (!selection) {
+            return;
+        }
+        if (editor.hasModel()) {
+            SnippetController2.get(editor)?.apply([{
+                    range: editor.getModel().getFullModelRange(),
+                    template: selection.snippet.body
+                }]);
+            editor.getModel().setLanguage(langService.createById(selection.langId), ApplyFileSnippetAction.Id);
+            editor.focus();
+        }
+    }
+    async _pick(quickInputService, langService, snippets) {
+        const all = [];
+        for (const snippet of snippets) {
+            if (isFalsyOrEmpty(snippet.scopes)) {
+                all.push({ langId: '', snippet });
+            }
+            else {
+                for (const langId of snippet.scopes) {
+                    all.push({ langId, snippet });
+                }
+            }
+        }
+        const picks = [];
+        const groups = groupBy(all, (a, b) => compare(a.langId, b.langId));
+        for (const group of groups) {
+            let first = true;
+            for (const item of group) {
+                if (first) {
+                    picks.push({
+                        type: 'separator',
+                        label: langService.getLanguageName(item.langId) ?? item.langId
+                    });
+                    first = false;
+                }
+                picks.push({
+                    snippet: item,
+                    label: item.snippet.prefix || item.snippet.name,
+                    detail: item.snippet.description
+                });
+            }
+        }
+        const pick = await quickInputService.pick(picks, {
+            placeHolder: ( localizeWithPath(
+                'vs/workbench/contrib/snippets/browser/commands/fileTemplateSnippets',
+                'placeholder',
+                'Select a snippet'
+            )),
+            matchOnDetail: true,
+        });
+        return pick?.snippet;
+    }
+}
+export { ApplyFileSnippetAction };

package/vscode/src/vs/workbench/contrib/terminal/browser/terminal.js

@@ -3,5 +3,8 @@ const ITerminalService = ( createDecorator('terminalService'));
 const ITerminalEditorService = ( createDecorator('terminalEditorService'));
 const ITerminalGroupService = ( createDecorator('terminalGroupService'));
 const ITerminalInstanceService = ( createDecorator('terminalInstanceService'));
+const isDetachedTerminalInstance = (t) => typeof t.instanceId !== 'number';
+class TerminalLinkQuickPickEvent extends MouseEvent {
+}
 const terminalEditorId = 'terminalEditor';
-export { ITerminalEditorService, ITerminalGroupService, ITerminalInstanceService, ITerminalService, terminalEditorId };
+export { ITerminalEditorService, ITerminalGroupService, ITerminalInstanceService, ITerminalService, TerminalLinkQuickPickEvent, isDetachedTerminalInstance, terminalEditorId };

package/vscode/src/vs/workbench/contrib/terminal/common/terminal.js

@@ -14,6 +14,7 @@ const SUGGESTIONS_FONT_WEIGHT = ['normal', 'bold', '100', '200', '300', '400', '
 const ITerminalProfileResolverService = ( createDecorator('terminalProfileResolverService'));
 const ITerminalProfileService = ( createDecorator('terminalProfileService'));
 const DEFAULT_LOCAL_ECHO_EXCLUDE = ['vim', 'vi', 'nano', 'tmux'];
+const isTerminalProcessManager = (t) => typeof t.write === 'function';
 const DEFAULT_COMMANDS_TO_SKIP_SHELL = [
     "workbench.action.terminal.clearSelection" ,
     "workbench.action.terminal.clear" ,
@@ -245,4 +246,4 @@ const terminalContributionsDescriptor = {
         },
     },
 };
-export { DEFAULT_BOLD_FONT_WEIGHT, DEFAULT_COMMANDS_TO_SKIP_SHELL, DEFAULT_FONT_WEIGHT, DEFAULT_LETTER_SPACING, DEFAULT_LINE_HEIGHT, DEFAULT_LOCAL_ECHO_EXCLUDE, ITerminalProfileResolverService, ITerminalProfileService, MAXIMUM_FONT_WEIGHT, MINIMUM_FONT_WEIGHT, MINIMUM_LETTER_SPACING, SUGGESTIONS_FONT_WEIGHT, TERMINAL_CONFIG_SECTION, TERMINAL_CREATION_COMMANDS, TERMINAL_VIEW_ID, terminalContributionsDescriptor };
+export { DEFAULT_BOLD_FONT_WEIGHT, DEFAULT_COMMANDS_TO_SKIP_SHELL, DEFAULT_FONT_WEIGHT, DEFAULT_LETTER_SPACING, DEFAULT_LINE_HEIGHT, DEFAULT_LOCAL_ECHO_EXCLUDE, ITerminalProfileResolverService, ITerminalProfileService, MAXIMUM_FONT_WEIGHT, MINIMUM_FONT_WEIGHT, MINIMUM_LETTER_SPACING, SUGGESTIONS_FONT_WEIGHT, TERMINAL_CONFIG_SECTION, TERMINAL_CREATION_COMMANDS, TERMINAL_VIEW_ID, isTerminalProcessManager, terminalContributionsDescriptor };

package/vscode/src/vs/workbench/contrib/welcomeGettingStarted/browser/featuredExtensionService.js

@@ -0,0 +1,159 @@
+import { __decorate, __param } from '../../../../../../../external/tslib/tslib.es6.js';
+import { createDecorator } from 'monaco-editor/esm/vs/platform/instantiation/common/instantiation.js';
+import { Disposable } from 'monaco-editor/esm/vs/base/common/lifecycle.js';
+import { IExtensionManagementService, IExtensionGalleryService } from '../../../../platform/extensionManagement/common/extensionManagement.js';
+import { IProductService } from 'monaco-editor/esm/vs/platform/product/common/productService.js';
+import { CancellationToken } from 'monaco-editor/esm/vs/base/common/cancellation.js';
+import { IStorageService } from 'monaco-editor/esm/vs/platform/storage/common/storage.js';
+import { localizeWithPath } from 'monaco-editor/esm/vs/nls.js';
+import { ExtensionIdentifier } from 'monaco-editor/esm/vs/platform/extensions/common/extensions.js';
+import { IExtensionService } from '../../../services/extensions/common/extensions.js';
+var FeaturedExtensionsService_1;
+const IFeaturedExtensionsService = ( createDecorator('featuredExtensionsService'));
+let FeaturedExtensionsService = class FeaturedExtensionsService extends Disposable {
+    static { FeaturedExtensionsService_1 = this; }
+    static { this.STORAGE_KEY = 'workbench.welcomePage.extensionMetadata'; }
+    constructor(extensionManagementService, extensionService, storageService, productService, galleryService) {
+        super();
+        this.extensionManagementService = extensionManagementService;
+        this.extensionService = extensionService;
+        this.storageService = storageService;
+        this.productService = productService;
+        this.galleryService = galleryService;
+        this.ignoredExtensions = ( new Set());
+        this._isInitialized = false;
+        this.title = ( localizeWithPath(
+            'vs/workbench/contrib/welcomeGettingStarted/browser/featuredExtensionService',
+            'gettingStarted.featuredTitle',
+            'Recommended'
+        ));
+    }
+    async getExtensions() {
+        await this._init();
+        const featuredExtensions = [];
+        for (const extension of this.productService.featuredExtensions?.filter(e => !( this.ignoredExtensions.has(e.id))) ?? []) {
+            const resolvedExtension = await this.resolveExtension(extension);
+            if (resolvedExtension) {
+                featuredExtensions.push(resolvedExtension);
+            }
+        }
+        return featuredExtensions;
+    }
+    async _init() {
+        if (this._isInitialized) {
+            return;
+        }
+        const featuredExtensions = this.productService.featuredExtensions;
+        if (!featuredExtensions) {
+            this._isInitialized = true;
+            return;
+        }
+        await this.extensionService.whenInstalledExtensionsRegistered();
+        const installed = await this.extensionManagementService.getInstalled();
+        for (const extension of featuredExtensions) {
+            if (( installed.some(e => ExtensionIdentifier.equals(e.identifier.id, extension.id)))) {
+                this.ignoredExtensions.add(extension.id);
+            }
+            else {
+                let galleryExtension;
+                try {
+                    galleryExtension = (await this.galleryService.getExtensions([{ id: extension.id }], CancellationToken.None))[0];
+                }
+                catch (err) {
+                    continue;
+                }
+                if (!(await this.extensionManagementService.canInstall(galleryExtension))) {
+                    this.ignoredExtensions.add(extension.id);
+                }
+            }
+        }
+        this._isInitialized = true;
+    }
+    async resolveExtension(productMetadata) {
+        const title = productMetadata.title ?? (await this.getMetadata(productMetadata.id, 0 ));
+        const description = productMetadata.description ?? (await this.getMetadata(productMetadata.id, 1 ));
+        const imagePath = productMetadata.imagePath ?? (await this.getMetadata(productMetadata.id, 2 ));
+        if (title && description && imagePath) {
+            return {
+                id: productMetadata.id,
+                title: title,
+                description: description,
+                imagePath: imagePath,
+            };
+        }
+        return undefined;
+    }
+    async getMetadata(extensionId, key) {
+        const storageMetadata = this.getStorageData(extensionId);
+        if (storageMetadata) {
+            switch (key) {
+                case 0 : {
+                    return storageMetadata.title;
+                }
+                case 1 : {
+                    return storageMetadata.description;
+                }
+                case 2 : {
+                    return storageMetadata.imagePath;
+                }
+                default:
+                    return undefined;
+            }
+        }
+        return await this.getGalleryMetadata(extensionId, key);
+    }
+    getStorageData(extensionId) {
+        const metadata = this.storageService.get(FeaturedExtensionsService_1.STORAGE_KEY + '.' + extensionId, -1 );
+        if (metadata) {
+            const value = JSON.parse(metadata);
+            const lastUpdateDate = ( new Date()).getTime() - value.date;
+            if (lastUpdateDate < 1000 * 60 * 60 * 24 * 7) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+    async getGalleryMetadata(extensionId, key) {
+        const storageKey = FeaturedExtensionsService_1.STORAGE_KEY + '.' + extensionId;
+        this.storageService.remove(storageKey, -1 );
+        let metadata;
+        let galleryExtension;
+        try {
+            galleryExtension = (await this.galleryService.getExtensions([{ id: extensionId }], CancellationToken.None))[0];
+        }
+        catch (err) {
+        }
+        if (!galleryExtension) {
+            return metadata;
+        }
+        switch (key) {
+            case 0 : {
+                metadata = galleryExtension.displayName;
+                break;
+            }
+            case 1 : {
+                metadata = galleryExtension.description;
+                break;
+            }
+            case 2 : {
+                metadata = galleryExtension.assets.icon?.uri;
+                break;
+            }
+        }
+        this.storageService.store(storageKey, JSON.stringify({
+            title: galleryExtension.displayName,
+            description: galleryExtension.description,
+            imagePath: galleryExtension.assets.icon?.uri,
+            date: ( new Date()).getTime()
+        }), -1 , 1 );
+        return metadata;
+    }
+};
+FeaturedExtensionsService = FeaturedExtensionsService_1 = ( __decorate([
+    ( __param(0, IExtensionManagementService)),
+    ( __param(1, IExtensionService)),
+    ( __param(2, IStorageService)),
+    ( __param(3, IProductService)),
+    ( __param(4, IExtensionGalleryService))
+], FeaturedExtensionsService));
+export { FeaturedExtensionsService, IFeaturedExtensionsService };

package/vscode/src/vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint.js

@@ -0,0 +1,375 @@
+import { localizeWithPath } from 'monaco-editor/esm/vs/nls.js';
+import { ExtensionsRegistry } from '../../../services/extensions/common/extensionsRegistry.js';
+const titleTranslated = ( localizeWithPath(
+    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+    'title',
+    "Title"
+));
+const walkthroughsExtensionPoint = ( ExtensionsRegistry.registerExtensionPoint({
+    extensionPoint: 'walkthroughs',
+    jsonSchema: {
+        description: ( localizeWithPath(
+            'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+            'walkthroughs',
+            "Contribute walkthroughs to help users getting started with your extension."
+        )),
+        type: 'array',
+        items: {
+            type: 'object',
+            required: ['id', 'title', 'description', 'steps'],
+            defaultSnippets: [{ body: { 'id': '$1', 'title': '$2', 'description': '$3', 'steps': [] } }],
+            properties: {
+                id: {
+                    type: 'string',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.id',
+                        "Unique identifier for this walkthrough."
+                    )),
+                },
+                title: {
+                    type: 'string',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.title',
+                        "Title of walkthrough."
+                    ))
+                },
+                icon: {
+                    type: 'string',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.icon',
+                        "Relative path to the icon of the walkthrough. The path is relative to the extension location. If not specified, the icon defaults to the extension icon if available."
+                    )),
+                },
+                description: {
+                    type: 'string',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.description',
+                        "Description of walkthrough."
+                    ))
+                },
+                featuredFor: {
+                    type: 'array',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.featuredFor',
+                        "Walkthroughs that match one of these glob patterns appear as 'featured' in workspaces with the specified files. For example, a walkthrough for TypeScript projects might specify `tsconfig.json` here."
+                    )),
+                    items: {
+                        type: 'string'
+                    },
+                },
+                when: {
+                    type: 'string',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.when',
+                        "Context key expression to control the visibility of this walkthrough."
+                    ))
+                },
+                steps: {
+                    type: 'array',
+                    description: ( localizeWithPath(
+                        'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                        'walkthroughs.steps',
+                        "Steps to complete as part of this walkthrough."
+                    )),
+                    items: {
+                        type: 'object',
+                        required: ['id', 'title', 'media'],
+                        defaultSnippets: [{
+                                body: {
+                                    'id': '$1', 'title': '$2', 'description': '$3',
+                                    'completionEvents': ['$5'],
+                                    'media': {},
+                                }
+                            }],
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.id',
+                                    "Unique identifier for this step. This is used to keep track of which steps have been completed."
+                                )),
+                            },
+                            title: {
+                                type: 'string',
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.title',
+                                    "Title of step."
+                                ))
+                            },
+                            description: {
+                                type: 'string',
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.description.interpolated',
+                                    "Description of step. Supports ``preformatted``, __italic__, and **bold** text. Use markdown-style links for commands or external links: {0}, {1}, or {2}. Links on their own line will be rendered as buttons.",
+                                    `[${titleTranslated}](command:myext.command)`,
+                                    `[${titleTranslated}](command:toSide:myext.command)`,
+                                    `[${titleTranslated}](https://aka.ms)`
+                                ))
+                            },
+                            button: {
+                                deprecationMessage: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.button.deprecated.interpolated',
+                                    "Deprecated. Use markdown links in the description instead, i.e. {0}, {1}, or {2}",
+                                    `[${titleTranslated}](command:myext.command)`,
+                                    `[${titleTranslated}](command:toSide:myext.command)`,
+                                    `[${titleTranslated}](https://aka.ms)`
+                                )),
+                            },
+                            media: {
+                                type: 'object',
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.media',
+                                    "Media to show alongside this step, either an image or markdown content."
+                                )),
+                                oneOf: [
+                                    {
+                                        required: ['image', 'altText'],
+                                        additionalProperties: false,
+                                        properties: {
+                                            path: {
+                                                deprecationMessage: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'pathDeprecated',
+                                                    "Deprecated. Please use `image` or `markdown` instead"
+                                                ))
+                                            },
+                                            image: {
+                                                description: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'walkthroughs.steps.media.image.path.string',
+                                                    "Path to an image - or object consisting of paths to light, dark, and hc images - relative to extension directory. Depending on context, the image will be displayed from 400px to 800px wide, with similar bounds on height. To support HIDPI displays, the image will be rendered at 1.5x scaling, for example a 900 physical pixels wide image will be displayed as 600 logical pixels wide."
+                                                )),
+                                                oneOf: [
+                                                    {
+                                                        type: 'string',
+                                                    },
+                                                    {
+                                                        type: 'object',
+                                                        required: ['dark', 'light', 'hc', 'hcLight'],
+                                                        properties: {
+                                                            dark: {
+                                                                description: ( localizeWithPath(
+                                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                                    'walkthroughs.steps.media.image.path.dark.string',
+                                                                    "Path to the image for dark themes, relative to extension directory."
+                                                                )),
+                                                                type: 'string',
+                                                            },
+                                                            light: {
+                                                                description: ( localizeWithPath(
+                                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                                    'walkthroughs.steps.media.image.path.light.string',
+                                                                    "Path to the image for light themes, relative to extension directory."
+                                                                )),
+                                                                type: 'string',
+                                                            },
+                                                            hc: {
+                                                                description: ( localizeWithPath(
+                                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                                    'walkthroughs.steps.media.image.path.hc.string',
+                                                                    "Path to the image for hc themes, relative to extension directory."
+                                                                )),
+                                                                type: 'string',
+                                                            },
+                                                            hcLight: {
+                                                                description: ( localizeWithPath(
+                                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                                    'walkthroughs.steps.media.image.path.hcLight.string',
+                                                                    "Path to the image for hc light themes, relative to extension directory."
+                                                                )),
+                                                                type: 'string',
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            },
+                                            altText: {
+                                                type: 'string',
+                                                description: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'walkthroughs.steps.media.altText',
+                                                    "Alternate text to display when the image cannot be loaded or in screen readers."
+                                                ))
+                                            }
+                                        }
+                                    },
+                                    {
+                                        required: ['svg', 'altText'],
+                                        additionalProperties: false,
+                                        properties: {
+                                            svg: {
+                                                description: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'walkthroughs.steps.media.image.path.svg',
+                                                    "Path to an svg, color tokens are supported in variables to support theming to match the workbench."
+                                                )),
+                                                type: 'string',
+                                            },
+                                            altText: {
+                                                type: 'string',
+                                                description: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'walkthroughs.steps.media.altText',
+                                                    "Alternate text to display when the image cannot be loaded or in screen readers."
+                                                ))
+                                            },
+                                        }
+                                    },
+                                    {
+                                        required: ['markdown'],
+                                        additionalProperties: false,
+                                        properties: {
+                                            path: {
+                                                deprecationMessage: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'pathDeprecated',
+                                                    "Deprecated. Please use `image` or `markdown` instead"
+                                                ))
+                                            },
+                                            markdown: {
+                                                description: ( localizeWithPath(
+                                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                    'walkthroughs.steps.media.markdown.path',
+                                                    "Path to the markdown document, relative to extension directory."
+                                                )),
+                                                type: 'string',
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            completionEvents: {
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.completionEvents',
+                                    "Events that should trigger this step to become checked off. If empty or not defined, the step will check off when any of the step's buttons or links are clicked; if the step has no buttons or links it will check on when it is selected."
+                                )),
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                    defaultSnippets: [
+                                        {
+                                            label: 'onCommand',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.onCommand',
+                                                'Check off step when a given command is executed anywhere in VS Code.'
+                                            )),
+                                            body: 'onCommand:${1:commandId}'
+                                        },
+                                        {
+                                            label: 'onLink',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.onLink',
+                                                'Check off step when a given link is opened via a walkthrough step.'
+                                            )),
+                                            body: 'onLink:${2:linkId}'
+                                        },
+                                        {
+                                            label: 'onView',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.onView',
+                                                'Check off step when a given view is opened'
+                                            )),
+                                            body: 'onView:${2:viewId}'
+                                        },
+                                        {
+                                            label: 'onSettingChanged',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.onSettingChanged',
+                                                'Check off step when a given setting is changed'
+                                            )),
+                                            body: 'onSettingChanged:${2:settingName}'
+                                        },
+                                        {
+                                            label: 'onContext',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.onContext',
+                                                'Check off step when a context key expression is true.'
+                                            )),
+                                            body: 'onContext:${2:key}'
+                                        },
+                                        {
+                                            label: 'onExtensionInstalled',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.extensionInstalled',
+                                                'Check off step when an extension with the given id is installed. If the extension is already installed, the step will start off checked.'
+                                            )),
+                                            body: 'onExtensionInstalled:${3:extensionId}'
+                                        },
+                                        {
+                                            label: 'onStepSelected',
+                                            description: ( localizeWithPath(
+                                                'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                                'walkthroughs.steps.completionEvents.stepSelected',
+                                                'Check off step as soon as it is selected.'
+                                            )),
+                                            body: 'onStepSelected'
+                                        },
+                                    ]
+                                }
+                            },
+                            doneOn: {
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.doneOn',
+                                    "Signal to mark step as complete."
+                                )),
+                                deprecationMessage: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.doneOn.deprecation',
+                                    "doneOn is deprecated. By default steps will be checked off when their buttons are clicked, to configure further use completionEvents"
+                                )),
+                                type: 'object',
+                                required: ['command'],
+                                defaultSnippets: [{ 'body': { command: '$1' } }],
+                                properties: {
+                                    'command': {
+                                        description: ( localizeWithPath(
+                                            'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                            'walkthroughs.steps.oneOn.command',
+                                            "Mark step done when the specified command is executed."
+                                        )),
+                                        type: 'string'
+                                    }
+                                },
+                            },
+                            when: {
+                                type: 'string',
+                                description: ( localizeWithPath(
+                                    'vs/workbench/contrib/welcomeGettingStarted/browser/gettingStartedExtensionPoint',
+                                    'walkthroughs.steps.when',
+                                    "Context key expression to control the visibility of this step."
+                                ))
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    activationEventsGenerator: (walkthroughContributions, result) => {
+        for (const walkthroughContribution of walkthroughContributions) {
+            if (walkthroughContribution.id) {
+                result.push(`onWalkthrough:${walkthroughContribution.id}`);
+            }
+        }
+    }
+}));
+export { walkthroughsExtensionPoint };