@codingame/monaco-vscode-task-service-override 20.1.0 → 20.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-task-service-override",
-  "version": "20.1.0",
+  "version": "20.2.0",
   "private": false,
   "description": "VSCode public API plugged on the monaco editor - task service-override",
   "keywords": [],
@@ -15,16 +15,16 @@
   },
   "type": "module",
   "dependencies": {
-    "@codingame/monaco-vscode-158b9837-fc78-5d9c-86f5-9134e4358643-common": "20.1.0",
-    "@codingame/monaco-vscode-262ed59d-4f76-57cd-9e9f-1877f26ae049-common": "20.1.0",
-    "@codingame/monaco-vscode-6883db80-c313-54eb-8fbc-5872c56b0326-common": "20.1.0",
-    "@codingame/monaco-vscode-a17e9d37-b6c1-5556-8402-5db73960fae3-common": "20.1.0",
-    "@codingame/monaco-vscode-ab07af84-42e8-5a0f-8aef-b83fb90ede21-common": "20.1.0",
-    "@codingame/monaco-vscode-api": "20.1.0",
-    "@codingame/monaco-vscode-bf94ddb5-e436-506a-9763-5ab86b642508-common": "20.1.0",
-    "@codingame/monaco-vscode-c2deffc4-ad68-5e63-8f95-9b89e0fc6898-common": "20.1.0",
-    "@codingame/monaco-vscode-ce7c734f-7712-563c-9335-d7acb43306af-common": "20.1.0",
-    "@codingame/monaco-vscode-ec8fe440-1fd1-523d-ad0f-c0f5a80cf451-common": "20.1.0"
+    "@codingame/monaco-vscode-158b9837-fc78-5d9c-86f5-9134e4358643-common": "20.2.0",
+    "@codingame/monaco-vscode-262ed59d-4f76-57cd-9e9f-1877f26ae049-common": "20.2.0",
+    "@codingame/monaco-vscode-6883db80-c313-54eb-8fbc-5872c56b0326-common": "20.2.0",
+    "@codingame/monaco-vscode-a17e9d37-b6c1-5556-8402-5db73960fae3-common": "20.2.0",
+    "@codingame/monaco-vscode-ab07af84-42e8-5a0f-8aef-b83fb90ede21-common": "20.2.0",
+    "@codingame/monaco-vscode-api": "20.2.0",
+    "@codingame/monaco-vscode-bf94ddb5-e436-506a-9763-5ab86b642508-common": "20.2.0",
+    "@codingame/monaco-vscode-c2deffc4-ad68-5e63-8f95-9b89e0fc6898-common": "20.2.0",
+    "@codingame/monaco-vscode-ce7c734f-7712-563c-9335-d7acb43306af-common": "20.2.0",
+    "@codingame/monaco-vscode-ec8fe440-1fd1-523d-ad0f-c0f5a80cf451-common": "20.2.0"
   },
   "main": "index.js",
   "module": "index.js",

package/vscode/src/vs/workbench/contrib/tasks/browser/abstractTaskService.d.ts

@@ -169,6 +169,9 @@ export declare abstract class AbstractTaskService extends Disposable implements
     registerTaskSystem(key: string, info: ITaskSystemInfo): void;
     private _getTaskSystemInfo;
     extensionCallbackTaskComplete(task: Task, result: number): Promise<void>;
+    /**
+     * Get a subset of workspace tasks that match a certain predicate.
+     */
     private _findWorkspaceTasks;
     private _findWorkspaceTasksInGroup;
     getTask(folder: IWorkspace | IWorkspaceFolder | string, identifier: string | ITaskIdentifier, compareId?: boolean, type?: string | undefined): Promise<Task | undefined>;
@@ -272,6 +275,12 @@ export declare abstract class AbstractTaskService extends Disposable implements
     private _doRunTaskCommand;
     rerun(terminalInstanceId: number): void;
     private _reRunTaskCommand;
+    /**
+     *
+     * @param tasks - The tasks which need to be filtered
+     * @param tasksInList - This tells splitPerGroupType to filter out globbed tasks (into defaults)
+     * @returns
+     */
     private _getDefaultTasks;
     private _runTaskGroupCommand;
     private _getGlobTasks;

package/vscode/src/vs/workbench/contrib/tasks/common/problemMatcher.d.ts

@@ -98,33 +98,106 @@ export interface ILineMatcher {
 export declare function createLineMatcher(matcher: ProblemMatcher, fileService?: IFileService): ILineMatcher;
 export declare namespace Config {
     interface IProblemPattern {
+        /**
+        * The regular expression to find a problem in the console output of an
+        * executed task.
+        */
         regexp?: string;
+        /**
+        * Whether the pattern matches a whole file, or a location (file/line)
+        *
+        * The default is to match for a location. Only valid on the
+        * first problem pattern in a multi line problem matcher.
+        */
         kind?: string;
+        /**
+        * The match group index of the filename.
+        * If omitted 1 is used.
+        */
         file?: number;
+        /**
+        * The match group index of the problem's location. Valid location
+        * patterns are: (line), (line,column) and (startLine,startColumn,endLine,endColumn).
+        * If omitted the line and column properties are used.
+        */
         location?: number;
+        /**
+        * The match group index of the problem's line in the source file.
+        *
+        * Defaults to 2.
+        */
         line?: number;
+        /**
+        * The match group index of the problem's column in the source file.
+        *
+        * Defaults to 3.
+        */
         column?: number;
+        /**
+        * The match group index of the problem's end line in the source file.
+        *
+        * Defaults to undefined. No end line is captured.
+        */
         endLine?: number;
+        /**
+        * The match group index of the problem's end column in the source file.
+        *
+        * Defaults to undefined. No end column is captured.
+        */
         endColumn?: number;
+        /**
+        * The match group index of the problem's severity.
+        *
+        * Defaults to undefined. In this case the problem matcher's severity
+        * is used.
+        */
         severity?: number;
+        /**
+        * The match group index of the problem's code.
+        *
+        * Defaults to undefined. No code is captured.
+        */
         code?: number;
+        /**
+        * The match group index of the message. If omitted it defaults
+        * to 4 if location is specified. Otherwise it defaults to 5.
+        */
         message?: number;
+        /**
+        * Specifies if the last pattern in a multi line problem matcher should
+        * loop as long as it does match a line consequently. Only valid on the
+        * last problem pattern in a multi line problem matcher.
+        */
         loop?: boolean;
     }
     interface ICheckedProblemPattern extends IProblemPattern {
+        /**
+        * The regular expression to find a problem in the console output of an
+        * executed task.
+        */
         regexp: string;
     }
     namespace CheckedProblemPattern {
         function is(value: any): value is ICheckedProblemPattern;
     }
     interface INamedProblemPattern extends IProblemPattern {
+        /**
+         * The name of the problem pattern.
+         */
         name: string;
+        /**
+         * A human readable label
+         */
         label?: string;
     }
     namespace NamedProblemPattern {
         function is(value: any): value is INamedProblemPattern;
     }
     interface INamedCheckedProblemPattern extends INamedProblemPattern {
+        /**
+        * The regular expression to find a problem in the console output of an
+        * executed task.
+        */
         regexp: string;
     }
     namespace NamedCheckedProblemPattern {
@@ -139,36 +212,146 @@ export declare namespace Config {
         function is(value: any): value is MultiLineCheckedProblemPattern;
     }
     interface INamedMultiLineCheckedProblemPattern {
+        /**
+         * The name of the problem pattern.
+         */
         name: string;
+        /**
+         * A human readable label
+         */
         label?: string;
+        /**
+         * The actual patterns
+         */
         patterns: MultiLineCheckedProblemPattern;
     }
     namespace NamedMultiLineCheckedProblemPattern {
         function is(value: any): value is INamedMultiLineCheckedProblemPattern;
     }
     type NamedProblemPatterns = (Config.INamedProblemPattern | Config.INamedMultiLineCheckedProblemPattern)[];
+    /**
+    * A watching pattern
+    */
     interface IWatchingPattern {
+        /**
+        * The actual regular expression
+        */
         regexp?: string;
+        /**
+        * The match group index of the filename. If provided the expression
+        * is matched for that file only.
+        */
         file?: number;
     }
+    /**
+    * A description to track the start and end of a watching task.
+    */
     interface IBackgroundMonitor {
+        /**
+        * If set to true the watcher starts in active mode. This is the
+        * same as outputting a line that matches beginsPattern when the
+        * task starts.
+        */
         activeOnStart?: boolean;
+        /**
+        * If matched in the output the start of a watching task is signaled.
+        */
         beginsPattern?: string | IWatchingPattern;
+        /**
+        * If matched in the output the end of a watching task is signaled.
+        */
         endsPattern?: string | IWatchingPattern;
     }
+    /**
+    * A description of a problem matcher that detects problems
+    * in build output.
+    */
     interface ProblemMatcher {
+        /**
+         * The name of a base problem matcher to use. If specified the
+         * base problem matcher will be used as a template and properties
+         * specified here will replace properties of the base problem
+         * matcher
+         */
         base?: string;
+        /**
+         * The owner of the produced VSCode problem. This is typically
+         * the identifier of a VSCode language service if the problems are
+         * to be merged with the one produced by the language service
+         * or a generated internal id. Defaults to the generated internal id.
+         */
         owner?: string;
+        /**
+         * A human-readable string describing the source of this problem.
+         * E.g. 'typescript' or 'super lint'.
+         */
         source?: string;
+        /**
+        * Specifies to which kind of documents the problems found by this
+        * matcher are applied. Valid values are:
+        *
+        *   "allDocuments": problems found in all documents are applied.
+        *   "openDocuments": problems found in documents that are open
+        *   are applied.
+        *   "closedDocuments": problems found in closed documents are
+        *   applied.
+        */
         applyTo?: string;
+        /**
+        * The severity of the VSCode problem produced by this problem matcher.
+        *
+        * Valid values are:
+        *   "error": to produce errors.
+        *   "warning": to produce warnings.
+        *   "info": to produce infos.
+        *
+        * The value is used if a pattern doesn't specify a severity match group.
+        * Defaults to "error" if omitted.
+        */
         severity?: string;
+        /**
+        * Defines how filename reported in a problem pattern
+        * should be read. Valid values are:
+        *  - "absolute": the filename is always treated absolute.
+        *  - "relative": the filename is always treated relative to
+        *    the current working directory. This is the default.
+        *  - ["relative", "path value"]: the filename is always
+        *    treated relative to the given path value.
+        *  - "autodetect": the filename is treated relative to
+        *    the current workspace directory, and if the file
+        *    does not exist, it is treated as absolute.
+        *  - ["autodetect", "path value"]: the filename is treated
+        *    relative to the given path value, and if it does not
+        *    exist, it is treated as absolute.
+        *  - ["search", { include?: "" | []; exclude?: "" | [] }]: The filename
+        *    needs to be searched under the directories named by the "include"
+        *    property and their nested subdirectories. With "exclude" property
+        *    present, the directories should be removed from the search. When
+        *    `include` is not unprovided, the current workspace directory should
+        *    be used as the default.
+        */
         fileLocation?: string | string[] | [
             "search",
             SearchFileLocationArgs
         ];
+        /**
+        * The name of a predefined problem pattern, the inline definition
+        * of a problem pattern or an array of problem patterns to match
+        * problems spread over multiple lines.
+        */
         pattern?: string | IProblemPattern | IProblemPattern[];
+        /**
+        * A regular expression signaling that a watched tasks begins executing
+        * triggered through file watching.
+        */
         watchedTaskBeginsRegExp?: string;
+        /**
+        * A regular expression signaling that a watched tasks ends executing.
+        */
         watchedTaskEndsRegExp?: string;
+        /**
+         * @deprecated Use background instead.
+         */
         watching?: IBackgroundMonitor;
         background?: IBackgroundMonitor;
     }
@@ -178,7 +361,14 @@ export declare namespace Config {
     };
     type ProblemMatcherType = string | ProblemMatcher | Array<string | ProblemMatcher>;
     interface INamedProblemMatcher extends ProblemMatcher {
+        /**
+        * This name can be used to refer to the
+        * problem matcher from within a task.
+        */
         name: string;
+        /**
+         * A human readable label.
+         */
         label?: string;
     }
     function isNamedProblemMatcher(value: ProblemMatcher): value is INamedProblemMatcher;

package/vscode/src/vs/workbench/contrib/tasks/common/taskConfiguration.d.ts

@@ -8,16 +8,34 @@ import { ITaskDefinitionRegistry } from "@codingame/monaco-vscode-api/vscode/vs/
 import { ConfiguredInput } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/configurationResolver/common/configurationResolver";
 import { IContextKeyService } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey.service";
 export declare enum ShellQuoting {
+    /**
+     * Default is character escaping.
+     */
     escape = 1,
+    /**
+     * Default is strong quoting
+     */
     strong = 2,
+    /**
+     * Default is weak quoting.
+     */
     weak = 3
 }
 export interface IShellQuotingOptions {
+    /**
+     * The character used to do character escaping.
+     */
     escape?: string | {
         escapeChar: string;
         charsToEscape: string;
     };
+    /**
+     * The character used for string quoting.
+     */
     strong?: string;
+    /**
+     * The character used for weak quoting.
+     */
     weak?: string;
 }
 export interface IShellConfiguration {
@@ -26,19 +44,60 @@ export interface IShellConfiguration {
     quoting?: IShellQuotingOptions;
 }
 export interface ICommandOptionsConfig {
+    /**
+     * The current working directory of the executed program or shell.
+     * If omitted VSCode's current workspace root is used.
+     */
     cwd?: string;
+    /**
+     * The additional environment of the executed program or shell. If omitted
+     * the parent process' environment is used.
+     */
     env?: IStringDictionary<string>;
+    /**
+     * The shell configuration;
+     */
     shell?: IShellConfiguration;
 }
 export interface IPresentationOptionsConfig {
+    /**
+     * Controls whether the terminal executing a task is brought to front or not.
+     * Defaults to `RevealKind.Always`.
+     */
     reveal?: string;
+    /**
+     * Controls whether the problems panel is revealed when running this task or not.
+     * Defaults to `RevealKind.Never`.
+     */
     revealProblems?: string;
+    /**
+     * Controls whether the executed command is printed to the output window or terminal as well.
+     */
     echo?: boolean;
+    /**
+     * Controls whether the terminal is focus when this task is executed
+     */
     focus?: boolean;
+    /**
+     * Controls whether the task runs in a new terminal
+     */
     panel?: string;
+    /**
+     * Controls whether to show the "Terminal will be reused by tasks, press any key to close it" message.
+     */
     showReuseMessage?: boolean;
+    /**
+     * Controls whether the terminal should be cleared before running the task.
+     */
     clear?: boolean;
+    /**
+     * Controls whether the task is executed in a specific terminal group using split panes.
+     */
     group?: string;
+    /**
+     * Controls whether the terminal that the task runs in is closed when the task completes.
+     * Note that if the terminal process exits with a non-zero exit code, it will not close.
+     */
     close?: boolean;
 }
 export interface IRunOptionsConfig {
@@ -55,17 +114,60 @@ export declare namespace ITaskIdentifier {
     function is(value: any): value is ITaskIdentifier;
 }
 export interface ILegacyTaskProperties {
+    /**
+     * @deprecated Use `isBackground` instead.
+     * Whether the executed command is kept alive and is watching the file system.
+     */
     isWatching?: boolean;
+    /**
+     * @deprecated Use `group` instead.
+     * Whether this task maps to the default build command.
+     */
     isBuildCommand?: boolean;
+    /**
+     * @deprecated Use `group` instead.
+     * Whether this task maps to the default test command.
+     */
     isTestCommand?: boolean;
 }
 export interface ILegacyCommandProperties {
+    /**
+     * Whether this is a shell or process
+     */
     type?: string;
+    /**
+     * @deprecated Use presentation options
+     * Controls whether the output view of the running tasks is brought to front or not.
+     * See BaseTaskRunnerConfiguration#showOutput for details.
+     */
     showOutput?: string;
+    /**
+     * @deprecated Use presentation options
+     * Controls whether the executed command is printed to the output windows as well.
+     */
     echoCommand?: boolean;
+    /**
+     * @deprecated Use presentation instead
+     */
     terminal?: IPresentationOptionsConfig;
+    /**
+     * @deprecated Use inline commands.
+     * See BaseTaskRunnerConfiguration#suppressTaskName for details.
+     */
     suppressTaskName?: boolean;
+    /**
+     * Some commands require that the task argument is highlighted with a special
+     * prefix (e.g. /t: for msbuild). This property can be used to control such
+     * a prefix.
+     */
     taskSelector?: string;
+    /**
+     * @deprecated use the task type instead.
+     * Specifies whether the command is a shell command and therefore must
+     * be executed in a shell interpreter (e.g. cmd.exe, bash, ...).
+     *
+     * Defaults to false if omitted.
+     */
     isShellCommand?: boolean | IShellConfiguration;
 }
 export type CommandString = string | string[] | {
@@ -76,13 +178,33 @@ export declare namespace CommandString {
     function value(value: CommandString): string;
 }
 export interface IBaseCommandProperties {
+    /**
+     * The command to be executed. Can be an external program or a shell
+     * command.
+     */
     command?: CommandString;
+    /**
+     * The command options used when the command is executed. Can be omitted.
+     */
     options?: ICommandOptionsConfig;
+    /**
+     * The arguments passed to the command or additional arguments passed to the
+     * command when using a global command.
+     */
     args?: CommandString[];
 }
 export interface ICommandProperties extends IBaseCommandProperties {
+    /**
+     * Windows specific command properties
+     */
     windows?: IBaseCommandProperties;
+    /**
+     * OSX specific command properties
+     */
     osx?: IBaseCommandProperties;
+    /**
+     * linux specific command properties
+     */
     linux?: IBaseCommandProperties;
 }
 export interface IGroupKind {
@@ -90,58 +212,213 @@ export interface IGroupKind {
     isDefault?: boolean | string;
 }
 export interface IConfigurationProperties {
+    /**
+     * The task's name
+     */
     taskName?: string;
+    /**
+     * The UI label used for the task.
+     */
     label?: string;
+    /**
+     * An optional identifier which can be used to reference a task
+     * in a dependsOn or other attributes.
+     */
     identifier?: string;
+    /**
+     * Whether the executed command is kept alive and runs in the background.
+     */
     isBackground?: boolean;
+    /**
+     * Whether the task should prompt on close for confirmation if running.
+     */
     promptOnClose?: boolean;
+    /**
+     * Defines the group the task belongs too.
+     */
     group?: string | IGroupKind;
+    /**
+     * A description of the task.
+     */
     detail?: string;
+    /**
+     * The other tasks the task depend on
+     */
     dependsOn?: string | ITaskIdentifier | Array<string | ITaskIdentifier>;
+    /**
+     * The order the dependsOn tasks should be executed in.
+     */
     dependsOrder?: string;
+    /**
+     * Controls the behavior of the used terminal
+     */
     presentation?: IPresentationOptionsConfig;
+    /**
+     * Controls shell options.
+     */
     options?: ICommandOptionsConfig;
+    /**
+     * The problem matcher(s) to use to capture problems in the tasks
+     * output.
+     */
     problemMatcher?: ProblemMatcherConfig.ProblemMatcherType;
+    /**
+     * Task run options. Control run related properties.
+     */
     runOptions?: IRunOptionsConfig;
+    /**
+     * The icon for this task in the terminal tabs list
+     */
     icon?: {
         id: string;
         color?: string;
     };
+    /**
+     * The icon's color in the terminal tabs list
+     */
     color?: string;
+    /**
+     * Do not show this task in the run task quickpick
+     */
     hide?: boolean;
 }
 export interface ICustomTask extends ICommandProperties, IConfigurationProperties {
+    /**
+     * Custom tasks have the type CUSTOMIZED_TASK_TYPE
+     */
     type?: string;
 }
 export interface IConfiguringTask extends IConfigurationProperties {
+    /**
+     * The contributed type of the task
+     */
     type?: string;
 }
+/**
+ * The base task runner configuration
+ */
 export interface IBaseTaskRunnerConfiguration {
+    /**
+     * The command to be executed. Can be an external program or a shell
+     * command.
+     */
     command?: CommandString;
+    /**
+     * @deprecated Use type instead
+     *
+     * Specifies whether the command is a shell command and therefore must
+     * be executed in a shell interpreter (e.g. cmd.exe, bash, ...).
+     *
+     * Defaults to false if omitted.
+     */
     isShellCommand?: boolean;
+    /**
+     * The task type
+     */
     type?: string;
+    /**
+     * The command options used when the command is executed. Can be omitted.
+     */
     options?: ICommandOptionsConfig;
+    /**
+     * The arguments passed to the command. Can be omitted.
+     */
     args?: CommandString[];
+    /**
+     * Controls whether the output view of the running tasks is brought to front or not.
+     * Valid values are:
+     *   "always": bring the output window always to front when a task is executed.
+     *   "silent": only bring it to front if no problem matcher is defined for the task executed.
+     *   "never": never bring the output window to front.
+     *
+     * If omitted "always" is used.
+     */
     showOutput?: string;
+    /**
+     * Controls whether the executed command is printed to the output windows as well.
+     */
     echoCommand?: boolean;
+    /**
+     * The group
+     */
     group?: string | IGroupKind;
+    /**
+     * Controls the behavior of the used terminal
+     */
     presentation?: IPresentationOptionsConfig;
+    /**
+     * If set to false the task name is added as an additional argument to the
+     * command when executed. If set to true the task name is suppressed. If
+     * omitted false is used.
+     */
     suppressTaskName?: boolean;
+    /**
+     * Some commands require that the task argument is highlighted with a special
+     * prefix (e.g. /t: for msbuild). This property can be used to control such
+     * a prefix.
+     */
     taskSelector?: string;
+    /**
+     * The problem matcher(s) to used if a global command is executed (e.g. no tasks
+     * are defined). A tasks.json file can either contain a global problemMatcher
+     * property or a tasks property but not both.
+     */
     problemMatcher?: ProblemMatcherConfig.ProblemMatcherType;
+    /**
+     * @deprecated Use `isBackground` instead.
+     *
+     * Specifies whether a global command is a watching the filesystem. A task.json
+     * file can either contain a global isWatching property or a tasks property
+     * but not both.
+     */
     isWatching?: boolean;
+    /**
+     * Specifies whether a global command is a background task.
+     */
     isBackground?: boolean;
+    /**
+     * Whether the task should prompt on close for confirmation if running.
+     */
     promptOnClose?: boolean;
+    /**
+     * The configuration of the available tasks. A tasks.json file can either
+     * contain a global problemMatcher property or a tasks property but not both.
+     */
     tasks?: Array<ICustomTask | IConfiguringTask>;
+    /**
+     * Problem matcher declarations.
+     */
     declares?: ProblemMatcherConfig.INamedProblemMatcher[];
+    /**
+     * Optional user input variables.
+     */
     inputs?: ConfiguredInput[];
 }
+/**
+ * A configuration of an external build system. BuildConfiguration.buildSystem
+ * must be set to 'program'
+ */
 export interface IExternalTaskRunnerConfiguration extends IBaseTaskRunnerConfiguration {
     _runner?: string;
+    /**
+     * Determines the runner to use
+     */
     runner?: string;
+    /**
+     * The config's version number
+     */
     version: string;
+    /**
+     * Windows specific task configuration
+     */
     windows?: IBaseTaskRunnerConfiguration;
+    /**
+     * Mac specific task configuration
+     */
     osx?: IBaseTaskRunnerConfiguration;
+    /**
+     * Linux specific task configuration
+     */
     linux?: IBaseTaskRunnerConfiguration;
 }
 type TaskConfigurationValueWithErrors<T> = {

package/vscode/src/vs/workbench/contrib/tasks/common/taskSystem.d.ts

@@ -49,6 +49,9 @@ export declare namespace Triggers {
     const reconnect: string;
 }
 export interface ITaskSummary {
+    /**
+     * Exit code of the process.
+     */
     exitCode?: number;
 }
 export declare enum TaskExecuteKind {

package/vscode/src/vs/workbench/contrib/tasks/common/taskTemplates.d.ts

@@ -5,3 +5,221 @@ export interface ITaskEntry extends IQuickPickItem {
     content: string;
 }
 export declare function getTemplates(): ITaskEntry[];
+/** Version 1.0 templates
+ *
+const gulp: TaskEntry = {
+    id: 'gulp',
+    label: 'Gulp',
+    autoDetect: true,
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "gulp",',
+        '\t"isShellCommand": true,',
+        '\t"args": ["--no-color"],',
+        '\t"showOutput": "always"',
+        '}'
+    ].join('\n')
+};
+
+const grunt: TaskEntry = {
+    id: 'grunt',
+    label: 'Grunt',
+    autoDetect: true,
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "grunt",',
+        '\t"isShellCommand": true,',
+        '\t"args": ["--no-color"],',
+        '\t"showOutput": "always"',
+        '}'
+    ].join('\n')
+};
+
+const npm: TaskEntry = {
+    id: 'npm',
+    label: 'npm',
+    sort: 'NPM',
+    autoDetect: false,
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "npm",',
+        '\t"isShellCommand": true,',
+        '\t"showOutput": "always",',
+        '\t"suppressTaskName": true,',
+        '\t"tasks": [',
+        '\t\t{',
+        '\t\t\t"taskName": "install",',
+        '\t\t\t"args": ["install"]',
+        '\t\t},',
+        '\t\t{',
+        '\t\t\t"taskName": "update",',
+        '\t\t\t"args": ["update"]',
+        '\t\t},',
+        '\t\t{',
+        '\t\t\t"taskName": "test",',
+        '\t\t\t"args": ["run", "test"]',
+        '\t\t}',
+        '\t]',
+        '}'
+    ].join('\n')
+};
+
+const tscConfig: TaskEntry = {
+    id: 'tsc.config',
+    label: 'TypeScript - tsconfig.json',
+    autoDetect: false,
+    description: nls.localize('tsc.config', 'Compiles a TypeScript project'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "tsc",',
+        '\t"isShellCommand": true,',
+        '\t"args": ["-p", "."],',
+        '\t"showOutput": "silent",',
+        '\t"problemMatcher": "$tsc"',
+        '}'
+    ].join('\n')
+};
+
+const tscWatch: TaskEntry = {
+    id: 'tsc.watch',
+    label: 'TypeScript - Watch Mode',
+    autoDetect: false,
+    description: nls.localize('tsc.watch', 'Compiles a TypeScript project in watch mode'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "tsc",',
+        '\t"isShellCommand": true,',
+        '\t"args": ["-w", "-p", "."],',
+        '\t"showOutput": "silent",',
+        '\t"isBackground": true,',
+        '\t"problemMatcher": "$tsc-watch"',
+        '}'
+    ].join('\n')
+};
+
+const dotnetBuild: TaskEntry = {
+    id: 'dotnetCore',
+    label: '.NET Core',
+    sort: 'NET Core',
+    autoDetect: false,
+    description: nls.localize('dotnetCore', 'Executes .NET Core build command'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "dotnet",',
+        '\t"isShellCommand": true,',
+        '\t"args": [],',
+        '\t"tasks": [',
+        '\t\t{',
+        '\t\t\t"taskName": "build",',
+        '\t\t\t"args": [ ],',
+        '\t\t\t"isBuildCommand": true,',
+        '\t\t\t"showOutput": "silent",',
+        '\t\t\t"problemMatcher": "$msCompile"',
+        '\t\t}',
+        '\t]',
+        '}'
+    ].join('\n')
+};
+
+const msbuild: TaskEntry = {
+    id: 'msbuild',
+    label: 'MSBuild',
+    autoDetect: false,
+    description: nls.localize('msbuild', 'Executes the build target'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "msbuild",',
+        '\t"args": [',
+        '\t\t// Ask msbuild to generate full paths for file names.',
+        '\t\t"/property:GenerateFullPaths=true"',
+        '\t],',
+        '\t"taskSelector": "/t:",',
+        '\t"showOutput": "silent",',
+        '\t"tasks": [',
+        '\t\t{',
+        '\t\t\t"taskName": "build",',
+        '\t\t\t// Show the output window only if unrecognized errors occur.',
+        '\t\t\t"showOutput": "silent",',
+        '\t\t\t// Use the standard MS compiler pattern to detect errors, warnings and infos',
+        '\t\t\t"problemMatcher": "$msCompile"',
+        '\t\t}',
+        '\t]',
+        '}'
+    ].join('\n')
+};
+
+const command: TaskEntry = {
+    id: 'externalCommand',
+    label: 'Others',
+    autoDetect: false,
+    description: nls.localize('externalCommand', 'Example to run an arbitrary external command'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "echo",',
+        '\t"isShellCommand": true,',
+        '\t"args": ["Hello World"],',
+        '\t"showOutput": "always"',
+        '}'
+    ].join('\n')
+};
+
+const maven: TaskEntry = {
+    id: 'maven',
+    label: 'maven',
+    sort: 'MVN',
+    autoDetect: false,
+    description: nls.localize('Maven', 'Executes common maven commands'),
+    content: [
+        '{',
+        '\t// See https://go.microsoft.com/fwlink/?LinkId=733558',
+        '\t// for the documentation about the tasks.json format',
+        '\t"version": "0.1.0",',
+        '\t"command": "mvn",',
+        '\t"isShellCommand": true,',
+        '\t"showOutput": "always",',
+        '\t"suppressTaskName": true,',
+        '\t"tasks": [',
+        '\t\t{',
+        '\t\t\t"taskName": "verify",',
+        '\t\t\t"args": ["-B", "verify"],',
+        '\t\t\t"isBuildCommand": true',
+        '\t\t},',
+        '\t\t{',
+        '\t\t\t"taskName": "test",',
+        '\t\t\t"args": ["-B", "test"],',
+        '\t\t\t"isTestCommand": true',
+        '\t\t}',
+        '\t]',
+        '}'
+    ].join('\n')
+};
+
+export let templates: TaskEntry[] = [gulp, grunt, tscConfig, tscWatch, dotnetBuild, msbuild, npm, maven].sort((a, b) => {
+    return (a.sort || a.label).localeCompare(b.sort || b.label);
+});
+templates.push(command);
+*/

package/vscode/src/vs/workbench/contrib/terminal/browser/terminalEscapeSequences.d.ts

@@ -1,20 +1,70 @@
+/**
+ * VS Code-specific shell integration sequences. Some of these are based on common alternatives like
+ * those pioneered in FinalTerm. The decision to move to entirely custom sequences was to try to
+ * improve reliability and prevent the possibility of applications confusing the terminal.
+ */
 export declare enum VSCodeOscPt {
+    /**
+     * The start of the prompt, this is expected to always appear at the start of a line.
+     * Based on FinalTerm's `OSC 133 ; A ST`.
+     */
     PromptStart = "A",
+    /**
+     * The start of a command, ie. where the user inputs their command.
+     * Based on FinalTerm's `OSC 133 ; B ST`.
+     */
     CommandStart = "B",
+    /**
+     * Sent just before the command output begins.
+     * Based on FinalTerm's `OSC 133 ; C ST`.
+     */
     CommandExecuted = "C",
+    /**
+     * Sent just after a command has finished. The exit code is optional, when not specified it
+     * means no command was run (ie. enter on empty prompt or ctrl+c).
+     * Based on FinalTerm's `OSC 133 ; D [; <ExitCode>] ST`.
+     */
     CommandFinished = "D",
+    /**
+     * Explicitly set the command line. This helps workaround problems with conpty not having a
+     * passthrough mode by providing an option on Windows to send the command that was run. With
+     * this sequence there's no need for the guessing based on the unreliable cursor positions that
+     * would otherwise be required.
+     */
     CommandLine = "E",
+    /**
+     * Similar to prompt start but for line continuations.
+     */
     ContinuationStart = "F",
+    /**
+     * Similar to command start but for line continuations.
+     */
     ContinuationEnd = "G",
+    /**
+     * The start of the right prompt.
+     */
     RightPromptStart = "H",
+    /**
+     * The end of the right prompt.
+     */
     RightPromptEnd = "I",
+    /**
+     * Set an arbitrary property: `OSC 633 ; P ; <Property>=<Value> ST`, only known properties will
+     * be handled.
+     */
     Property = "P"
 }
 export declare enum VSCodeOscProperty {
     Task = "Task",
     Cwd = "Cwd"
 }
+/**
+ * ITerm sequences
+ */
 export declare enum ITermOscPt {
+    /**
+     * Based on ITerm's `OSC 1337 ; SetMark` sets a mark on the scrollbar
+     */
     SetMark = "SetMark"
 }
 export declare function VSCodeSequence(osc: VSCodeOscPt, data?: string | VSCodeOscProperty): string;