diff --git a/CHANGELOG.md b/CHANGELOG.md index d2dbff0..e391393 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p - Adds new _Open File_ command (with _Open Revision_ as an `alt-click`) to files in comparisons — closes [#1710](https://github.com/eamodio/vscode-gitlens/issues/1710) - Adds commit message autolinking of merged pull requests for Azure Repos — closes [#1486](https://github.com/eamodio/vscode-gitlens/issues/1486) thanks to [PR #1487](https://github.com/eamodio/vscode-gitlens/pull/1487) by Mark Molinaro ([@markjm](https://github.com/markjm)) - Adds a new `AzureDevOps` type to `gitlens.remotes` to better support Azure DevOps remote matching — thanks to [PR #1487](https://github.com/eamodio/vscode-gitlens/pull/1487) by Dmitry Gurovich ([@yrtimiD](https://github.com/yrtimiD)) +- Adds functional groupings to all GitLens settings when using the VS Code settings UI. Groups will be displayed in the table of contents in the settings UI — thanks to @rzhao271 for adding grouping support to VS Code settings UI ### Fixed diff --git a/package.json b/package.json index 883f850..4334244 100644 --- a/package.json +++ b/package.json @@ -198,1115 +198,2481 @@ } }, "contributes": { - "configuration": { - "type": "object", - "title": "GitLens — Use 'GitLens: Open Settings' for a richer, interactive experience", - "properties": { - "gitlens.autolinks": { - "type": [ - "array", - "null" - ], - "default": null, - "items": { - "type": "object", - "required": [ - "prefix", - "url" + "configuration": [ + { + "title": "Current Line Blame", + "order": 10, + "properties": { + "gitlens.currentLine.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a blame annotation for the current line, by default. Use the `Toggle Line Blame Annotations` command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window", + "scope": "window", + "order": 10 + }, + "gitlens.currentLine.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the current line blame annotation. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 20 + }, + "gitlens.currentLine.format": { + "type": "string", + "default": "${author, }${agoOrDate}${' via 'pullRequest}${ • message|50?}", + "markdownDescription": "Specifies the format of the current line blame annotation. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.currentLine.dateFormat#` setting", + "scope": "window", + "order": 30 + }, + "gitlens.currentLine.scrollable": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport. **NOTE**: Setting this to `false` will inhibit the hovers from showing over the annotation; Set `#gitlens.hovers.currentLine.over#` to `line` to enable the hovers to show anywhere over the line.", + "scope": "window", + "order": 40 + }, + "gitlens.currentLine.dateFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) for the current line blame annotation. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Git Code Lens", + "order": 11, + "properties": { + "gitlens.codeLens.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide any Git code lens, by default. Use the `Toggle Git Code Lens` command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window", + "scope": "window", + "order": 10 + }, + "gitlens.codeLens.authors.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one)", + "scope": "window", + "order": 20 + }, + "gitlens.codeLens.authors.command": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "gitlens.toggleFileBlame", + "gitlens.toggleFileHeatmap", + "gitlens.toggleFileChanges", + "gitlens.toggleFileChangesOnly", + "gitlens.diffWithPrevious", + "gitlens.revealCommitInView", + "gitlens.showCommitsInView", + "gitlens.showQuickCommitDetails", + "gitlens.showQuickCommitFileDetails", + "gitlens.showQuickFileHistory", + "gitlens.showQuickRepoHistory", + "gitlens.openCommitOnRemote", + "gitlens.copyRemoteCommitUrl", + "gitlens.openFileOnRemote", + "gitlens.copyRemoteFileUrl" + ], + "enumDescriptions": [ + "Disables click interaction", + "Toggles file blame", + "Toggles file heatmap", + "Toggles file changes since before the commit", + "Toggles file changes from the commit", + "Compares the current committed file with the previous commit", + "Reveals the commit in the Side Bar", + "Searches for commits within the range", + "Shows a commit details quick pick menu", + "Shows a commit file details quick pick menu", + "Shows a file history quick pick menu", + "Shows a branch history quick pick menu", + "Opens the commit on the remote service (when available)", + "Copies the remote commit url to the clipboard (when available)", + "Opens the file revision on the remote service (when available)", + "Copies the remote file url to the clipboard (when available)" + ], + "default": "gitlens.toggleFileBlame", + "markdownDescription": "Specifies the command to be executed when an _authors_ code lens is clicked", + "scope": "window", + "order": 21 + }, + "gitlens.codeLens.recentChange.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block", + "scope": "window", + "order": 30 + }, + "gitlens.codeLens.recentChange.command": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "gitlens.toggleFileBlame", + "gitlens.toggleFileHeatmap", + "gitlens.toggleFileChanges", + "gitlens.toggleFileChangesOnly", + "gitlens.diffWithPrevious", + "gitlens.revealCommitInView", + "gitlens.showCommitsInView", + "gitlens.showQuickCommitDetails", + "gitlens.showQuickCommitFileDetails", + "gitlens.showQuickFileHistory", + "gitlens.showQuickRepoHistory", + "gitlens.openCommitOnRemote", + "gitlens.copyRemoteCommitUrl", + "gitlens.openFileOnRemote", + "gitlens.copyRemoteFileUrl" + ], + "enumDescriptions": [ + "Disables click interaction", + "Toggles file blame", + "Toggles file heatmap", + "Toggles file changes since before the commit", + "Toggles file changes from the commit", + "Compares the current committed file with the previous commit", + "Reveals the commit in the Side Bar", + "Searches for the commit", + "Shows a commit details quick pick menu", + "Shows a commit file details quick pick menu", + "Shows a file history quick pick menu", + "Shows a branch history quick pick menu", + "Opens the commit on the remote service (when available)", + "Copies the remote commit url to the clipboard (when available)", + "Opens the file revision on the remote service (when available)", + "Copies the remote file url to the clipboard (when available)" + ], + "default": "gitlens.showQuickCommitFileDetails", + "markdownDescription": "Specifies the command to be executed when a _recent change_ code lens is clicked", + "scope": "window", + "order": 31 + }, + "gitlens.codeLens.scopes": { + "type": "array", + "default": [ + "document", + "containers" + ], + "items": { + "type": "string", + "enum": [ + "document", + "containers", + "blocks" + ], + "enumDescriptions": [ + "Adds code lens at the top of the document", + "Adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)", + "Adds code lens at the start of block-like symbols (functions, methods, etc) lines" + ] + }, + "minItems": 0, + "maxItems": 3, + "uniqueItems": true, + "markdownDescription": "Specifies where Git code lens will be shown in the document", + "scope": "language-overridable", + "order": 40 + }, + "gitlens.codeLens.symbolScopes": { + "type": "array", + "items": { + "type": "string" + }, + "uniqueItems": true, + "markdownDescription": "Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of `SymbolKind`", + "scope": "language-overridable", + "order": 50 + }, + "gitlens.codeLens.includeSingleLineSymbols": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to provide any Git code lens on symbols that span only a single line", + "scope": "window", + "order": 60 + }, + "gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors": { + "type": "string", + "default": "$(ellipsis)", + "markdownDescription": "Specifies the string to be shown in place of both the _recent change_ and _authors_ code lens when there are unsaved changes", + "scope": "window", + "order": 70 + }, + "gitlens.strings.codeLens.unsavedChanges.recentChangeOnly": { + "type": "string", + "default": "$(ellipsis)", + "markdownDescription": "Specifies the string to be shown in place of the _recent change_ code lens when there are unsaved changes", + "scope": "window", + "order": 71 + }, + "gitlens.strings.codeLens.unsavedChanges.authorsOnly": { + "type": "string", + "default": "$(ellipsis)", + "markdownDescription": "Specifies the string to be shown in place of the _authors_ code lens when there are unsaved changes", + "scope": "window", + "order": 72 + }, + "gitlens.codeLens.scopesByLanguage": { + "deprecationMessage": "Deprecated. Use per-language `gitlens.codeLens.scopes` and `gitlens.codeLens.symbolScopes` settings instead", + "markdownDeprecationMessage": "Deprecated. Use the per-language `#gitlens.codeLens.scopes#` and `#gitlens.codeLens.symbolScopes#` settings instead" + } + } + }, + { + "title": "Status Bar Blame", + "order": 12, + "properties": { + "gitlens.statusBar.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide blame information in the status bar", + "scope": "window", + "order": 10 + }, + "gitlens.statusBar.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the status bar. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 20 + }, + "gitlens.statusBar.format": { + "type": "string", + "default": "${author}, ${agoOrDate}${' via 'pullRequest}", + "markdownDescription": "Specifies the format of the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.statusBar.dateFormat#` setting", + "scope": "window", + "order": 30 + }, + "gitlens.statusBar.alignment": { + "type": "string", + "default": "right", + "enum": [ + "left", + "right" + ], + "enumDescriptions": [ + "Aligns to the left", + "Aligns to the right" + ], + "markdownDescription": "Specifies the blame alignment in the status bar", + "scope": "window", + "order": 40 + }, + "gitlens.statusBar.command": { + "type": "string", + "default": "gitlens.showQuickCommitDetails", + "enum": [ + "gitlens.toggleFileBlame", + "gitlens.toggleFileHeatmap", + "gitlens.toggleFileChanges", + "gitlens.toggleFileChangesOnly", + "gitlens.toggleCodeLens", + "gitlens.diffWithPrevious", + "gitlens.diffWithWorking", + "gitlens.revealCommitInView", + "gitlens.showCommitsInView", + "gitlens.showQuickCommitDetails", + "gitlens.showQuickCommitFileDetails", + "gitlens.showQuickFileHistory", + "gitlens.showQuickRepoHistory", + "gitlens.openCommitOnRemote", + "gitlens.copyRemoteCommitUrl", + "gitlens.openFileOnRemote", + "gitlens.copyRemoteFileUrl" + ], + "enumDescriptions": [ + "Toggles file blame", + "Toggles file heatmap", + "Toggles file changes since before the commit", + "Toggles file changes from the commit", + "Toggles Git code lens", + "Compares the current line commit with the previous", + "Compares the current line commit with the working tree", + "Reveals the commit in the Side Bar", + "Searches for the commit", + "Shows a commit details quick pick menu", + "Shows a commit file details quick pick menu", + "Shows a file history quick pick menu", + "Shows a branch history quick pick menu", + "Opens the commit on the remote service (when available)", + "Copies the remote commit url to the clipboard (when available)", + "Opens the file revision on the remote service (when available)", + "Copies the remote file url to the clipboard (when available)" + ], + "markdownDescription": "Specifies the command to be executed when the blame status bar item is clicked", + "scope": "window", + "order": 50 + }, + "gitlens.statusBar.tooltipFormat": { + "type": "string", + "default": "${avatar}  __${author}__, ${ago}${' via 'pullRequest}   _(${date})_ \n\n${message}\n\n${commands}${\n\n---\n\nfootnotes}", + "markdownDescription": "Specifies the format (in markdown) of hover shown over the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 60 + }, + "gitlens.statusBar.reduceFlicker": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar \"flashing\"", + "scope": "window", + "order": 70 + }, + "gitlens.statusBar.dateFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 80 + } + } + }, + { + "title": "Hovers", + "order": 13, + "properties": { + "gitlens.hovers.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide any hovers", + "scope": "window", + "order": 10 + }, + "gitlens.hovers.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images in hovers", + "scope": "window", + "order": 20 + }, + "gitlens.hovers.avatarSize": { + "type": "number", + "default": 32, + "markdownDescription": "Specifies the size of the avatar images in hovers", + "scope": "window", + "order": 21 + }, + "gitlens.hovers.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the hovers. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 30 + }, + "gitlens.hovers.autolinks.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to automatically link external resources in commit messages", + "scope": "window", + "order": 31 + }, + "gitlens.hovers.autolinks.enhanced": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to lookup additional details about automatically link external resources in commit messages. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 32 + }, + "gitlens.hovers.currentLine.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide any hovers for the current line", + "scope": "window", + "order": 40 + }, + "gitlens.hovers.currentLine.over": { + "type": "string", + "default": "annotation", + "enum": [ + "annotation", + "line" + ], + "enumDescriptions": [ + "Only shown when hovering over the line annotation", + "Shown when hovering anywhere over the line" + ], + "markdownDescription": "Specifies when to trigger hovers for the current line", + "scope": "window", + "order": 41 + }, + "gitlens.hovers.currentLine.details": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a _commit details_ hover for the current line", + "scope": "window", + "order": 42 + }, + "gitlens.hovers.currentLine.changes": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a _changes (diff)_ hover for the current line", + "scope": "window", + "order": 43 + }, + "gitlens.hovers.annotations.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide any hovers when showing blame annotations", + "scope": "window", + "order": 50 + }, + "gitlens.hovers.annotations.over": { + "type": "string", + "default": "line", + "enum": [ + "annotation", + "line" + ], + "enumDescriptions": [ + "Only shown when hovering over the line annotation", + "Shown when hovering anywhere over the line" + ], + "markdownDescription": "Specifies when to trigger hovers when showing blame annotations", + "scope": "window", + "order": 51 + }, + "gitlens.hovers.annotations.details": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a _commit details_ hover for all lines when showing blame annotations", + "scope": "window", + "order": 52 + }, + "gitlens.hovers.annotations.changes": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a _changes (diff)_ hover for all lines when showing blame annotations", + "scope": "window", + "order": 53 + }, + "gitlens.hovers.detailsMarkdownFormat": { + "type": "string", + "default": "${avatar}  __${author}__, ${ago}${' via 'pullRequest}   _(${date})_ \n\n${message}\n\n${commands}${\n\n---\n\nfootnotes}", + "markdownDescription": "Specifies the format (in markdown) of the _commit details_ hover. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 60 + }, + "gitlens.hovers.changesDiff": { + "type": "string", + "default": "line", + "enum": [ + "line", + "hunk" + ], + "enumDescriptions": [ + "Shows only the changes to the line", + "Shows the set of related changes" + ], + "markdownDescription": "Specifies whether to show just the changes to the line or the set of related changes in the _changes (diff)_ hover", + "scope": "window", + "order": 70 + } + } + }, + { + "title": "Views", + "order": 20, + "properties": { + "gitlens.views.defaultItemLimit": { + "type": "number", + "default": 10, + "markdownDescription": "Specifies the default number of items to show in a view list. Use 0 to specify no limit", + "scope": "window", + "order": 10 + }, + "gitlens.views.pageItemLimit": { + "type": "number", + "default": 40, + "markdownDescription": "Specifies the number of items to show in a each page when paginating a view list. Use 0 to specify no limit", + "scope": "window", + "order": 11 + }, + "gitlens.views.showRelativeDateMarkers": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show relative date markers (_Less than a week ago_, _Over a week ago_, _Over a month ago_, etc) on revision (commit) histories in the views", + "scope": "window", + "order": 20 + }, + "gitlens.views.formats.commits.label": { + "type": "string", + "default": "${❰ tips ❱➤ }${message}", + "markdownDescription": "Specifies the format of commits in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 30 + }, + "gitlens.views.formats.commits.description": { + "type": "string", + "default": "${author, }${agoOrDate}", + "markdownDescription": "Specifies the description format of commits in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 31 + }, + "gitlens.views.formats.files.label": { + "type": "string", + "default": "${working }${file}", + "markdownDescription": "Specifies the format of a file in the views. See [_File Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#file-tokens) in the GitLens docs", + "scope": "window", + "order": 32 + }, + "gitlens.views.formats.files.description": { + "type": "string", + "default": "${directory}${ ← originalPath}", + "markdownDescription": "Specifies the description format of a file in the views. See [_File Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#file-tokens) in the GitLens docs", + "scope": "window", + "order": 33 + }, + "gitlens.views.formats.stashes.label": { + "type": "string", + "default": "${message}", + "markdownDescription": "Specifies the format of stashes in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 34 + }, + "gitlens.views.formats.stashes.description": { + "type": "string", + "default": "${agoOrDate}", + "markdownDescription": "Specifies the description format of stashes in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", + "scope": "window", + "order": 35 + }, + "gitlens.views.commitFileFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" + }, + "gitlens.views.commitFileDescriptionFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" + }, + "gitlens.views.commitFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.commits.label` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.commits.files.label#` instead" + }, + "gitlens.views.commitDescriptionFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.commits.description` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.commits.description#` instead" + }, + "gitlens.views.stashFileFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" + }, + "gitlens.views.stashFileDescriptionFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" + }, + "gitlens.views.stashFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.stashes.label` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.stashes.files.label#` instead" + }, + "gitlens.views.stashDescriptionFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.stashes.description` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.stashes.description#` instead" + }, + "gitlens.views.statusFileFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" + }, + "gitlens.views.statusFileDescriptionFormat": { + "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", + "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" + } + } + }, + { + "title": "Commits View", + "order": 21, + "properties": { + "gitlens.views.commits.showBranchComparison": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "branch", + "working" + ], + "enumDescriptions": [ + "Hides the branch comparison", + "Compares the current branch with a user-selected reference", + "Compares the working tree with a user-selected reference" + ], + "default": "working", + "markdownDescription": "Specifies whether to show a comparison of the current branch or the working tree with a user-selected reference (branch, tag. etc) in the _Commits_ view", + "scope": "window", + "order": 10 + }, + "gitlens.views.commits.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with the current branch and commits in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 21 + }, + "gitlens.views.commits.pullRequests.showForBranches": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with the current branch in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 21 + }, + "gitlens.views.commits.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 22 + }, + "gitlens.views.commits.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.commits.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Commits_ view will display files", + "scope": "window", + "order": 30 + }, + "gitlens.views.commits.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Commits_ view. Only applies when `#gitlens.views.commits.files.layout#` is set to `auto`", + "scope": "window", + "order": 31 + }, + "gitlens.views.commits.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Commits_ view. Only applies when `#gitlens.views.commits.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 32 + }, + "gitlens.views.commits.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Commits_ view", + "scope": "window", + "order": 40 + }, + "gitlens.views.commits.reveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to reveal commits in the _Commits_ view, otherwise they revealed in the _Repositories_ view", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Repositories View", + "order": 22, + "properties": { + "gitlens.views.repositories.showBranchComparison": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "branch", + "working" + ], + "enumDescriptions": [ + "Hides the branch comparison", + "Compares the current branch with a user-selected reference", + "Compares the working tree with a user-selected reference" + ], + "default": "working", + "markdownDescription": "Specifies whether to show a comparison of the current branch or the working tree with a user-selected reference (branch, tag. etc) in the _Repositories_ view", + "scope": "window", + "order": 10 + }, + "gitlens.views.repositories.showUpstreamStatus": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the upstream status of the current branch for each repository in the _Repositories_ view", + "scope": "window", + "order": 11 + }, + "gitlens.views.repositories.includeWorkingTree": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to include working tree file status for each repository in the _Repositories_ view", + "scope": "window", + "order": 12 + }, + "gitlens.views.repositories.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 20 + }, + "gitlens.views.repositories.pullRequests.showForBranches": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 21 + }, + "gitlens.views.repositories.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 22 + }, + "gitlens.views.repositories.showCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the commits on the current branch for each repository in the _Repositories_ view", + "scope": "window", + "order": 30 + }, + "gitlens.views.repositories.showBranches": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the branches for each repository in the _Repositories_ view", + "scope": "window", + "order": 31 + }, + "gitlens.views.repositories.showRemotes": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the remotes for each repository in the _Repositories_ view", + "scope": "window", + "order": 32 + }, + "gitlens.views.repositories.showStashes": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the stashes for each repository in the _Repositories_ view", + "scope": "window", + "order": 33 + }, + "gitlens.views.repositories.showTags": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the tags for each repository in the _Repositories_ view", + "scope": "window", + "order": 34 + }, + "gitlens.views.repositories.showContributors": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the contributors for each repository in the _Repositories_ view", + "scope": "window", + "order": 35 + }, + "gitlens.views.repositories.showIncomingActivity": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to show the experimental incoming activity for each repository in the _Repositories_ view", + "scope": "window", + "order": 36 + }, + "gitlens.views.repositories.autoRefresh": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to automatically refresh the _Repositories_ view when the repository or the file system changes", + "scope": "window", + "order": 40 + }, + "gitlens.views.repositories.autoReveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to automatically reveal repositories in the _Repositories_ view when opening files", + "scope": "window", + "order": 50 + }, + "gitlens.views.repositories.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Repositories_ view", + "scope": "window", + "order": 60 + }, + "gitlens.views.repositories.branches.layout": { + "type": "string", + "default": "tree", + "enum": [ + "list", + "tree" + ], + "enumDescriptions": [ + "Displays branches as a list", + "Displays branches as a tree when branch names contain slashes `/`" + ], + "markdownDescription": "Specifies how the _Repositories_ view will display branches", + "scope": "window", + "order": 70 + }, + "gitlens.views.repositories.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.repositories.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Repositories_ view will display files", + "scope": "window", + "order": 80 + }, + "gitlens.views.repositories.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Repositories_ view. Only applies when `#gitlens.views.repositories.files.layout#` is set to `auto`", + "scope": "window", + "order": 81 + }, + "gitlens.views.repositories.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Repositories_ view. Only applies when `#gitlens.views.repositories.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 82 + }, + "gitlens.views.repositories.compact": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to show the _Repositories_ view in a compact display density", + "scope": "window", + "order": 90 + }, + "gitlens.views.repositories.branches.showBranchComparison": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "branch" + ], + "enumDescriptions": [ + "Hides the branch comparison", + "Compares the branch with a user-selected reference" + ], + "default": "branch", + "markdownDescription": "Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) under each branch in the _Repositories_ view", + "scope": "window", + "order": 100 + }, + "gitlens.views.repositories.enabled": { + "deprecationMessage": "Deprecated. This setting is no longer used", + "markdownDeprecationMessage": "Deprecated. This setting is no longer used" + } + } + }, + { + "title": "File History View", + "order": 23, + "properties": { + "gitlens.views.fileHistory.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.fileHistory.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _File History_ view will display files when showing the history of a folder", + "scope": "window", + "order": 10 + }, + "gitlens.views.fileHistory.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _File History_ view. Only applies to folder history and when `#gitlens.views.fileHistory.files.layout#` is set to `auto`", + "scope": "window", + "order": 11 + }, + "gitlens.views.fileHistory.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _File History_ view. Only applies to folder history and when `#gitlens.views.fileHistory.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 12 + }, + "gitlens.views.fileHistory.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of status icons in the _File History_ view", + "scope": "window", + "order": 20 + }, + "gitlens.advanced.fileHistoryFollowsRenames": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether file histories will follow renames — will affect how merge commits are shown in histories", + "scope": "window", + "order": 100 + }, + "gitlens.advanced.fileHistoryShowAllBranches": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether file histories will show commits from all branches", + "scope": "window", + "order": 101 + } + } + }, + { + "title": "Line History View", + "order": 24, + "properties": { + "gitlens.views.lineHistory.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of status icons in the _Line History_ view", + "scope": "window", + "order": 10 + }, + "gitlens.views.lineHistory.enabled": { + "deprecationMessage": "Deprecated. This setting is no longer used", + "markdownDeprecationMessage": "Deprecated. This setting is no longer used" + } + } + }, + { + "title": "Branches View", + "order": 25, + "properties": { + "gitlens.views.branches.showBranchComparison": { + "type": [ + "boolean", + "string" + ], + "enum": [ + false, + "branch" + ], + "enumDescriptions": [ + "Hides the branch comparison", + "Compares the branch with a user-selected reference" + ], + "default": "branch", + "markdownDescription": "Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) in the _Branches_ view", + "scope": "window", + "order": 10 + }, + "gitlens.views.branches.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 20 + }, + "gitlens.views.branches.pullRequests.showForBranches": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 21 + }, + "gitlens.views.branches.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 22 + }, + "gitlens.views.branches.branches.layout": { + "type": "string", + "default": "tree", + "enum": [ + "list", + "tree" + ], + "enumDescriptions": [ + "Displays branches as a list", + "Displays branches as a tree when branch names contain slashes `/`" + ], + "markdownDescription": "Specifies how the _Branches_ view will display branches", + "scope": "window", + "order": 30 + }, + "gitlens.sortBranchesBy": { + "type": "string", + "default": "date:desc", + "enum": [ + "date:desc", + "date:asc", + "name:asc", + "name:desc" + ], + "enumDescriptions": [ + "Sorts branches by the most recent commit date in descending order", + "Sorts branches by the most recent commit date in ascending order", + "Sorts branches by name in ascending order", + "Sorts branches by name in descending order" + ], + "markdownDescription": "Specifies how branches are sorted in quick pick menus and views", + "scope": "window", + "order": 40 + }, + "gitlens.views.branches.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.branches.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Branches_ view will display files", + "scope": "window", + "order": 50 + }, + "gitlens.views.branches.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Branches_ view. Only applies when `#gitlens.views.branches.files.layout#` is set to `auto`", + "scope": "window", + "order": 51 + }, + "gitlens.views.branches.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Branches_ view. Only applies when `#gitlens.views.branches.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 52 + }, + "gitlens.views.branches.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Branches_ view", + "scope": "window", + "order": 60 + }, + "gitlens.views.branches.reveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to reveal branches in the _Branches_ view, otherwise they revealed in the _Repositories_ view", + "scope": "window", + "order": 70 + } + } + }, + { + "title": "Remotes View", + "order": 26, + "properties": { + "gitlens.views.remotes.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 10 + }, + "gitlens.views.remotes.pullRequests.showForBranches": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 11 + }, + "gitlens.views.remotes.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 12 + }, + "gitlens.views.remotes.branches.layout": { + "type": "string", + "default": "tree", + "enum": [ + "list", + "tree" + ], + "enumDescriptions": [ + "Displays branches as a list", + "Displays branches as a tree when branch names contain slashes `/`" + ], + "markdownDescription": "Specifies how the _Remotes_ view will display branches", + "scope": "window", + "order": 20 + }, + "gitlens.views.remotes.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.remotes.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Remotes_ view will display files", + "scope": "window", + "order": 30 + }, + "gitlens.views.remotes.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Remotes_ view. Only applies when `#gitlens.views.remotes.files.layout#` is set to `auto`", + "scope": "window", + "order": 31 + }, + "gitlens.views.remotes.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Remotes_ view. Only applies when `#gitlens.views.remotes.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 32 + }, + "gitlens.views.remotes.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Remotes_ view", + "scope": "window", + "order": 40 + }, + "gitlens.views.remotes.reveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to reveal remotes in the _Remotes_ view, otherwise they revealed in the _Repositories_ view", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Stashes View", + "order": 27, + "properties": { + "gitlens.views.stashes.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" ], - "properties": { - "prefix": { - "type": "string", - "description": "Specifies the short prefix to use to generate autolinks for the external resource" - }, - "title": { - "type": [ - "string", - "null" - ], - "default": null, - "description": "Specifies an optional title for the generated autolink. Use `` as the variable for the reference number" - }, - "url": { - "type": "string", - "description": "Specifies the url of the external resource you want to link to. Use `` as the variable for the reference number" - }, - "alphanumeric": { - "type": "boolean", - "description": "Specifies whether alphanumeric characters should be allowed in ``", - "default": false - }, - "ignoreCase": { - "type": "boolean", - "description": "Specifies whether case should be ignored when matching the prefix", - "default": false - } - }, - "additionalProperties": false - }, - "uniqueItems": true, - "markdownDescription": "Specifies autolinks to external resources in commit messages. Use `` as the variable for the reference number", - "scope": "window" - }, - "gitlens.blame.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images in the gutter blame annotations", - "scope": "window" - }, - "gitlens.blame.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (deduplicate) matching adjacent gutter blame annotations", - "scope": "window" - }, - "gitlens.blame.dateFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) in gutter blame annotations. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.blame.format": { - "type": "string", - "default": "${message|50?} ${agoOrDate|14-}", - "markdownDescription": "Specifies the format of the gutter blame annotations. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.blame.dateFormat#` setting", - "scope": "window" - }, - "gitlens.blame.heatmap.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a heatmap indicator in the gutter blame annotations", - "scope": "window" - }, - "gitlens.blame.heatmap.location": { - "type": "string", - "default": "right", - "enum": [ - "left", - "right" - ], - "enumDescriptions": [ - "Adds a heatmap indicator on the left edge of the gutter blame annotations", - "Adds a heatmap indicator on the right edge of the gutter blame annotations" - ], - "markdownDescription": "Specifies where the heatmap indicators will be shown in the gutter blame annotations", - "scope": "window" - }, - "gitlens.blame.highlight.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to highlight lines associated with the current line", - "scope": "window" - }, - "gitlens.blame.highlight.locations": { - "type": "array", - "default": [ - "gutter", - "line", - "overview" - ], - "items": { + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.stashes.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Stashes_ view will display files", + "scope": "window", + "order": 10 + }, + "gitlens.views.stashes.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Stashes_ view. Only applies when `#gitlens.views.stashes.files.layout#` is set to `auto`", + "scope": "window", + "order": 11 + }, + "gitlens.views.stashes.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Stashes_ view. Only applies when `#gitlens.views.stashes.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 12 + }, + "gitlens.views.stashes.reveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to reveal stashes in the _Stashes_ view, otherwise they revealed in the _Repositories_ view", + "scope": "window", + "order": 20 + } + } + }, + { + "title": "Tags View", + "order": 28, + "properties": { + "gitlens.views.tags.branches.layout": { "type": "string", + "default": "tree", "enum": [ - "gutter", - "line", - "overview" + "list", + "tree" ], "enumDescriptions": [ - "Adds a gutter indicator", - "Adds a full-line highlight background color", - "Adds a decoration to the overview ruler (scroll bar)" - ] - }, - "minItems": 1, - "maxItems": 3, - "uniqueItems": true, - "markdownDescription": "Specifies where the associated line highlights will be shown", - "scope": "window" - }, - "gitlens.blame.ignoreWhitespace": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to ignore whitespace when comparing revisions during blame operations", - "scope": "resource" - }, - "gitlens.blame.separateLines": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether gutter blame annotations will be separated by a small gap", - "scope": "window" - }, - "gitlens.blame.toggleMode": { - "type": "string", - "default": "file", - "enum": [ - "file", - "window" - ], - "enumDescriptions": [ - "Toggles each file individually", - "Toggles the window, i.e. all files at once" - ], - "markdownDescription": "Specifies how the gutter blame annotations will be toggled", - "scope": "window" - }, - "gitlens.changes.locations": { - "type": "array", - "default": [ - "gutter", - "overview" - ], - "items": { + "Displays tags as a list", + "Displays tags as a tree when tags names contain slashes `/`" + ], + "markdownDescription": "Specifies how the _Tags_ view will display tags", + "scope": "window", + "order": 10 + }, + "gitlens.sortTagsBy": { "type": "string", + "default": "date:desc", "enum": [ - "gutter", - "overview" + "date:desc", + "date:asc", + "name:asc", + "name:desc" + ], + "enumDescriptions": [ + "Sorts tags by date in descending order", + "Sorts tags by date in ascending order", + "Sorts tags by name in ascending order", + "Sorts tags by name in descending order" + ], + "markdownDescription": "Specifies how tags are sorted in quick pick menus and views", + "scope": "window", + "order": 20 + }, + "gitlens.views.tags.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" ], "enumDescriptions": [ - "Adds a gutter indicator", - "Adds a decoration to the overview ruler (scroll bar)" - ] - }, - "minItems": 1, - "maxItems": 2, - "uniqueItems": true, - "markdownDescription": "Specifies where the indicators of the gutter changes annotations will be shown", - "scope": "window" - }, - "gitlens.changes.toggleMode": { - "type": "string", - "default": "file", - "enum": [ - "file", - "window" - ], - "enumDescriptions": [ - "Toggles each file individually", - "Toggles the window, i.e. all files at once" - ], - "markdownDescription": "Specifies how the gutter changes annotations will be toggled", - "scope": "window" - }, - "gitlens.codeLens.authors.command": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "gitlens.toggleFileBlame", - "gitlens.toggleFileHeatmap", - "gitlens.toggleFileChanges", - "gitlens.toggleFileChangesOnly", - "gitlens.diffWithPrevious", - "gitlens.revealCommitInView", - "gitlens.showCommitsInView", - "gitlens.showQuickCommitDetails", - "gitlens.showQuickCommitFileDetails", - "gitlens.showQuickFileHistory", - "gitlens.showQuickRepoHistory", - "gitlens.openCommitOnRemote", - "gitlens.copyRemoteCommitUrl", - "gitlens.openFileOnRemote", - "gitlens.copyRemoteFileUrl" - ], - "enumDescriptions": [ - "Disables click interaction", - "Toggles file blame", - "Toggles file heatmap", - "Toggles file changes since before the commit", - "Toggles file changes from the commit", - "Compares the current committed file with the previous commit", - "Reveals the commit in the Side Bar", - "Searches for commits within the range", - "Shows a commit details quick pick menu", - "Shows a commit file details quick pick menu", - "Shows a file history quick pick menu", - "Shows a branch history quick pick menu", - "Opens the commit on the remote service (when available)", - "Copies the remote commit url to the clipboard (when available)", - "Opens the file revision on the remote service (when available)", - "Copies the remote file url to the clipboard (when available)" - ], - "default": "gitlens.toggleFileBlame", - "markdownDescription": "Specifies the command to be executed when an _authors_ code lens is clicked", - "scope": "window" - }, - "gitlens.codeLens.authors.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one)", - "scope": "window" - }, - "gitlens.codeLens.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide any Git code lens, by default. Use the `Toggle Git Code Lens` command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window", - "scope": "window" - }, - "gitlens.codeLens.includeSingleLineSymbols": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to provide any Git code lens on symbols that span only a single line", - "scope": "window" - }, - "gitlens.codeLens.recentChange.command": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "gitlens.toggleFileBlame", - "gitlens.toggleFileHeatmap", - "gitlens.toggleFileChanges", - "gitlens.toggleFileChangesOnly", - "gitlens.diffWithPrevious", - "gitlens.revealCommitInView", - "gitlens.showCommitsInView", - "gitlens.showQuickCommitDetails", - "gitlens.showQuickCommitFileDetails", - "gitlens.showQuickFileHistory", - "gitlens.showQuickRepoHistory", - "gitlens.openCommitOnRemote", - "gitlens.copyRemoteCommitUrl", - "gitlens.openFileOnRemote", - "gitlens.copyRemoteFileUrl" - ], - "enumDescriptions": [ - "Disables click interaction", - "Toggles file blame", - "Toggles file heatmap", - "Toggles file changes since before the commit", - "Toggles file changes from the commit", - "Compares the current committed file with the previous commit", - "Reveals the commit in the Side Bar", - "Searches for the commit", - "Shows a commit details quick pick menu", - "Shows a commit file details quick pick menu", - "Shows a file history quick pick menu", - "Shows a branch history quick pick menu", - "Opens the commit on the remote service (when available)", - "Copies the remote commit url to the clipboard (when available)", - "Opens the file revision on the remote service (when available)", - "Copies the remote file url to the clipboard (when available)" - ], - "default": "gitlens.showQuickCommitFileDetails", - "markdownDescription": "Specifies the command to be executed when a _recent change_ code lens is clicked", - "scope": "window" - }, - "gitlens.codeLens.recentChange.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block", - "scope": "window" - }, - "gitlens.codeLens.scopes": { - "type": "array", - "default": [ - "document", - "containers" - ], - "items": { + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.tags.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Tags_ view will display files", + "scope": "window", + "order": 30 + }, + "gitlens.views.tags.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Tags_ view. Only applies when `#gitlens.views.tags.files.layout#` is set to `auto`", + "scope": "window", + "order": 31 + }, + "gitlens.views.tags.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Tags_ view. Only applies when `#gitlens.views.tags.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 32 + }, + "gitlens.views.tags.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Tags_ view", + "scope": "window", + "order": 40 + }, + "gitlens.views.tags.reveal": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to reveal tags in the _Tags_ view, otherwise they revealed in the _Repositories_ view", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Contributors View", + "order": 29, + "properties": { + "gitlens.views.contributors.showAllBranches": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to show commits from all branches in the _Contributors_ view", + "scope": "window", + "order": 10 + }, + "gitlens.views.contributors.showStatistics": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to show contributor statistics in the _Contributors_ view. This can take a while to compute depending on the repository size", + "scope": "window", + "order": 20 + }, + "gitlens.views.contributors.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Contributors_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 30 + }, + "gitlens.views.contributors.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Contributors_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 31 + }, + "gitlens.sortContributorsBy": { "type": "string", + "default": "count:desc", "enum": [ - "document", - "containers", - "blocks" + "count:desc", + "count:asc", + "date:desc", + "date:asc", + "name:asc", + "name:desc" ], "enumDescriptions": [ - "Adds code lens at the top of the document", - "Adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)", - "Adds code lens at the start of block-like symbols (functions, methods, etc) lines" - ] - }, - "minItems": 0, - "maxItems": 3, - "uniqueItems": true, - "markdownDescription": "Specifies where Git code lens will be shown in the document", - "scope": "language-overridable" - }, - "gitlens.codeLens.scopesByLanguage": { - "deprecationMessage": "Deprecated. Use per-language `gitlens.codeLens.scopes` and `gitlens.codeLens.symbolScopes` settings instead", - "markdownDeprecationMessage": "Deprecated. Use the per-language `#gitlens.codeLens.scopes#` and `#gitlens.codeLens.symbolScopes#` settings instead" - }, - "gitlens.codeLens.symbolScopes": { - "type": "array", - "items": { - "type": "string" - }, - "uniqueItems": true, - "markdownDescription": "Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of `SymbolKind`", - "scope": "language-overridable" - }, - "gitlens.currentLine.dateFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) for the current line blame annotation. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.currentLine.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a blame annotation for the current line, by default. Use the `Toggle Line Blame Annotations` command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window", - "scope": "window" - }, - "gitlens.currentLine.format": { - "type": "string", - "default": "${author, }${agoOrDate}${' via 'pullRequest}${ • message|50?}", - "markdownDescription": "Specifies the format of the current line blame annotation. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.currentLine.dateFormat#` setting", - "scope": "window" - }, - "gitlens.currentLine.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the current line blame annotation. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.currentLine.scrollable": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport. **NOTE**: Setting this to `false` will inhibit the hovers from showing over the annotation; Set `#gitlens.hovers.currentLine.over#` to `line` to enable the hovers to show anywhere over the line.", - "scope": "window" - }, - "gitlens.debug": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies debug mode", - "scope": "window" - }, - "gitlens.defaultDateFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.defaultDateShortFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how short absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.defaultDateSource": { - "type": "string", - "default": "authored", - "enum": [ - "authored", - "committed" - ], - "enumDescriptions": [ - "Uses the date when the changes were authored (i.e. originally written)", - "Uses the date when the changes were committed" - ], - "markdownDescription": "Specifies whether commit dates should use the authored or committed date", - "scope": "window" - }, - "gitlens.defaultDateStyle": { - "type": "string", - "default": "relative", - "enum": [ - "relative", - "absolute" - ], - "enumDescriptions": [ - "e.g. 1 day ago", - "e.g. July 25th, 2018 7:18pm" - ], - "markdownDescription": "Specifies how dates will be displayed by default", - "scope": "window" - }, - "gitlens.defaultGravatarsStyle": { - "type": "string", - "default": "robohash", - "enum": [ - "identicon", - "mp", - "monsterid", - "retro", - "robohash", - "wavatar" - ], - "enumDescriptions": [ - "A geometric pattern", - "A simple, cartoon-style silhouetted outline of a person (does not vary by email hash)", - "A monster with different colors, faces, etc", - "8-bit arcade-style pixelated faces", - "A robot with different colors, faces, etc", - "A face with differing features and backgrounds" - ], - "markdownDescription": "Specifies the style of the gravatar default (fallback) images", - "scope": "window" - }, - "gitlens.defaultTimeFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how times will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.fileAnnotations.command": { - "type": [ - "string", - "null" - ], - "default": null, - "enum": [ - null, - "blame", - "heatmap", - "changes" - ], - "enumDescriptions": [ - "Shows a menu to choose which file annotations to toggle", - "Toggles gutter blame annotations", - "Toggles gutter heatmap annotations", - "Toggles gutter changes annotations" - ], - "markdownDescription": "Specifies whether the file annotations button in the editor title shows a menu or immediately toggles the specified file annotations", - "scope": "window" - }, - "gitlens.gitCommands.closeOnFocusOut": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to dismiss the _Git Command Palette_ when focus is lost (if not, press `ESC` to dismiss)", - "scope": "window" - }, - "gitlens.gitCommands.search.matchAll": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to match all or any commit message search patterns", - "scope": "window" - }, - "gitlens.gitCommands.search.matchCase": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to match commit search patterns with or without regard to casing", - "scope": "window" - }, - "gitlens.gitCommands.search.matchRegex": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to match commit search patterns using regular expressions", - "scope": "window" - }, - "gitlens.gitCommands.search.showResultsInView": { - "deprecationMessage": "Deprecated. This setting has been renamed to gitlens.gitCommands.search.showResultsInSideBar", - "markdownDeprecationMessage": "Deprecated. This setting has been renamed to `#gitlens.gitCommands.search.showResultsInSideBar#`" - }, - "gitlens.gitCommands.search.showResultsInSideBar": { - "type": [ - "boolean", - "null" - ], - "default": null, - "markdownDescription": "Specifies whether to show the commit search results directly in the quick pick menu, in the Side Bar, or will be based on the context", - "scope": "window" - }, - "gitlens.gitCommands.skipConfirmations": { - "type": "array", - "default": [ - "fetch:command", - "stash-push:command", - "switch:command" - ], - "items": { + "Sorts contributors by commit count in descending order", + "Sorts contributors by commit count in ascending order", + "Sorts contributors by the most recent commit date in descending order", + "Sorts contributors by the most recent commit date in ascending order", + "Sorts contributors by name in ascending order", + "Sorts contributors by name in descending order" + ], + "markdownDescription": "Specifies how contributors are sorted in quick pick menus and views", + "scope": "window", + "order": 40 + }, + "gitlens.views.contributors.files.layout": { "type": "string", + "default": "auto", "enum": [ - "branch-create:command", - "branch-create:menu", - "co-authors:command", - "co-authors:menu", - "fetch:command", - "fetch:menu", - "pull:command", - "pull:menu", - "push:command", - "push:menu", - "stash-apply:command", - "stash-apply:menu", - "stash-pop:command", - "stash-pop:menu", - "stash-push:command", - "stash-push:menu", - "switch:command", - "switch:menu", - "tag-create:command", - "tag-create:menu" + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.contributors.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Contributors_ view will display files", + "scope": "window", + "order": 50 + }, + "gitlens.views.contributors.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Contributors_ view. Only applies when `#gitlens.views.contributors.files.layout#` is set to `auto`", + "scope": "window", + "order": 51 + }, + "gitlens.views.contributors.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Contributors_ view. Only applies when `#gitlens.views.contributors.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 52 + }, + "gitlens.views.contributors.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Contributors_ view", + "scope": "window", + "order": 60 + } + } + }, + { + "title": "Search & Compare View", + "order": 29, + "properties": { + "gitlens.views.searchAndCompare.pullRequests.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to query for pull requests associated with commits in the _Search & Compare_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 10 + }, + "gitlens.views.searchAndCompare.pullRequests.showForCommits": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Search & Compare_ view. Requires a connection to a supported remote service (e.g. GitHub)", + "scope": "window", + "order": 11 + }, + "gitlens.views.searchAndCompare.files.layout": { + "type": "string", + "default": "auto", + "enum": [ + "auto", + "list", + "tree" + ], + "enumDescriptions": [ + "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.searchAndCompare.files.threshold#` value and the number of files at each nesting level", + "Displays files as a list", + "Displays files as a tree" + ], + "markdownDescription": "Specifies how the _Search & Compare_ view will display files", + "scope": "window", + "order": 20 + }, + "gitlens.views.searchAndCompare.files.threshold": { + "type": "number", + "default": 5, + "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Search & Compare_ view. Only applies when `#gitlens.views.searchAndCompare.files.layout#` is set to `auto`", + "scope": "window", + "order": 21 + }, + "gitlens.views.searchAndCompare.files.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Search & Compare_ view. Only applies when `#gitlens.views.searchAndCompare.files.layout#` is set to `tree` or `auto`", + "scope": "window", + "order": 22 + }, + "gitlens.views.searchAndCompare.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Search & Compare_ view", + "scope": "window", + "order": 30 + } + } + }, + { + "title": "Gutter Blame", + "order": 100, + "properties": { + "gitlens.blame.toggleMode": { + "type": "string", + "default": "file", + "enum": [ + "file", + "window" + ], + "enumDescriptions": [ + "Toggles each file individually", + "Toggles the window, i.e. all files at once" + ], + "markdownDescription": "Specifies how the gutter blame annotations will be toggled", + "scope": "window", + "order": 10 + }, + "gitlens.blame.format": { + "type": "string", + "default": "${message|50?} ${agoOrDate|14-}", + "markdownDescription": "Specifies the format of the gutter blame annotations. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.blame.dateFormat#` setting", + "scope": "window", + "order": 20 + }, + "gitlens.blame.heatmap.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide a heatmap indicator in the gutter blame annotations", + "scope": "window", + "order": 30 + }, + "gitlens.blame.heatmap.location": { + "type": "string", + "default": "right", + "enum": [ + "left", + "right" + ], + "enumDescriptions": [ + "Adds a heatmap indicator on the left edge of the gutter blame annotations", + "Adds a heatmap indicator on the right edge of the gutter blame annotations" + ], + "markdownDescription": "Specifies where the heatmap indicators will be shown in the gutter blame annotations", + "scope": "window", + "order": 31 + }, + "gitlens.blame.avatars": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show avatar images in the gutter blame annotations", + "scope": "window", + "order": 40 + }, + "gitlens.blame.compact": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to compact (deduplicate) matching adjacent gutter blame annotations", + "scope": "window", + "order": 50 + }, + "gitlens.blame.highlight.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to highlight lines associated with the current line", + "scope": "window", + "order": 60 + }, + "gitlens.blame.highlight.locations": { + "type": "array", + "default": [ + "gutter", + "line", + "overview" + ], + "items": { + "type": "string", + "enum": [ + "gutter", + "line", + "overview" + ], + "enumDescriptions": [ + "Adds a gutter indicator", + "Adds a full-line highlight background color", + "Adds a decoration to the overview ruler (scroll bar)" + ] + }, + "minItems": 1, + "maxItems": 3, + "uniqueItems": true, + "markdownDescription": "Specifies where the associated line highlights will be shown", + "scope": "window", + "order": 61 + }, + "gitlens.blame.separateLines": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether gutter blame annotations will be separated by a small gap", + "scope": "window", + "order": 70 + }, + "gitlens.blame.dateFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) in gutter blame annotations. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 80 + } + } + }, + { + "title": "Gutter Changes", + "order": 101, + "properties": { + "gitlens.changes.toggleMode": { + "type": "string", + "default": "file", + "enum": [ + "file", + "window" ], "enumDescriptions": [ - "Skips branch create confirmations when run from a command, e.g. a view action", - "Skips branch create confirmations when run from the Git Command Palette", - "Skips co-author confirmations when run from a command, e.g. a view action", - "Skips co-author confirmations when run from the Git Command Palette", - "Skips fetch confirmations when run from a command, e.g. a view action", - "Skips fetch confirmations when run from the Git Command Palette", - "Skips pull confirmations when run from a command, e.g. a view action", - "Skips pull confirmations when run from the Git Command Palette", - "Skips push confirmations when run from a command, e.g. a view action", - "Skips push confirmations when run from the Git Command Palette", - "Skips stash apply confirmations when run from a command, e.g. a view action", - "Skips stash apply confirmations when run from the Git Command Palette", - "Skips stash pop confirmations when run from a command, e.g. a view action", - "Skips stash pop confirmations when run from the Git Command Palette", - "Skips stash push confirmations when run from a command, e.g. a view action", - "Skips stash push confirmations when run from the Git Command Palette", - "Skips switch confirmations when run from a command, e.g. a view action", - "Skips switch confirmations when run from the Git Command Palette", - "Skips tag create confirmations when run from a command, e.g. a view action", - "Skips tag create confirmations when run from the Git Command Palette" - ] - }, - "minItems": 0, - "maxItems": 14, - "uniqueItems": true, - "markdownDescription": "Specifies which (and when) Git commands will skip the confirmation step, using the format: `git-command-name:(menu|command)`", - "scope": "window" - }, - "gitlens.gitCommands.sortBy": { - "type": "string", - "default": "usage", - "enum": [ - "name", - "usage" - ], - "enumDescriptions": [ - "Sorts commands by name", - "Sorts commands by last used date" - ], - "markdownDescription": "Specifies how Git commands are sorted in the _Git Command Palette_", - "scope": "window" - }, - "gitlens.heatmap.ageThreshold": { - "type": "number", - "default": 90, - "markdownDescription": "Specifies the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use `#gitlens.heatmap.coldColor#` instead of `#gitlens.heatmap.hotColor#`)", - "scope": "window" - }, - "gitlens.heatmap.coldColor": { - "type": "string", - "default": "#0a60f6", - "markdownDescription": "Specifies the base color of the gutter heatmap annotations when the most recent change is older (cold) than the `#gitlens.heatmap.ageThreshold#` value", - "scope": "window" - }, - "gitlens.heatmap.hotColor": { - "type": "string", - "default": "#f66a0a", - "markdownDescription": "Specifies the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the `#gitlens.heatmap.ageThreshold#` value", - "scope": "window" - }, - "gitlens.heatmap.locations": { - "type": "array", - "default": [ - "gutter", - "overview" - ], - "items": { + "Toggles each file individually", + "Toggles the window, i.e. all files at once" + ], + "markdownDescription": "Specifies how the gutter changes annotations will be toggled", + "scope": "window", + "order": 10 + }, + "gitlens.changes.locations": { + "type": "array", + "default": [ + "gutter", + "overview" + ], + "items": { + "type": "string", + "enum": [ + "gutter", + "overview" + ], + "enumDescriptions": [ + "Adds a gutter indicator", + "Adds a decoration to the overview ruler (scroll bar)" + ] + }, + "minItems": 1, + "maxItems": 2, + "uniqueItems": true, + "markdownDescription": "Specifies where the indicators of the gutter changes annotations will be shown", + "scope": "window", + "order": 20 + } + } + }, + { + "title": "Gutter Heatmap", + "order": 102, + "properties": { + "gitlens.heatmap.toggleMode": { "type": "string", + "default": "file", "enum": [ + "file", + "window" + ], + "enumDescriptions": [ + "Toggles each file individually", + "Toggles the window, i.e. all files at once" + ], + "markdownDescription": "Specifies how the gutter heatmap annotations will be toggled", + "scope": "window", + "order": 10 + }, + "gitlens.heatmap.locations": { + "type": "array", + "default": [ "gutter", "overview" ], + "items": { + "type": "string", + "enum": [ + "gutter", + "overview" + ], + "enumDescriptions": [ + "Adds a gutter indicator", + "Adds a decoration to the overview ruler (scroll bar)" + ] + }, + "minItems": 1, + "maxItems": 2, + "uniqueItems": true, + "markdownDescription": "Specifies where the indicators of the gutter heatmap annotations will be shown", + "scope": "window", + "order": 20 + }, + "gitlens.heatmap.ageThreshold": { + "type": "number", + "default": 90, + "markdownDescription": "Specifies the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use `#gitlens.heatmap.coldColor#` instead of `#gitlens.heatmap.hotColor#`)", + "scope": "window", + "order": 30 + }, + "gitlens.heatmap.coldColor": { + "type": "string", + "default": "#0a60f6", + "markdownDescription": "Specifies the base color of the gutter heatmap annotations when the most recent change is older (cold) than the `#gitlens.heatmap.ageThreshold#` value", + "scope": "window", + "order": 40 + }, + "gitlens.heatmap.hotColor": { + "type": "string", + "default": "#f66a0a", + "markdownDescription": "Specifies the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the `#gitlens.heatmap.ageThreshold#` value", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Git Command Palette", + "order": 110, + "properties": { + "gitlens.gitCommands.sortBy": { + "type": "string", + "default": "usage", + "enum": [ + "name", + "usage" + ], "enumDescriptions": [ - "Adds a gutter indicator", - "Adds a decoration to the overview ruler (scroll bar)" - ] - }, - "minItems": 1, - "maxItems": 2, - "uniqueItems": true, - "markdownDescription": "Specifies where the indicators of the gutter heatmap annotations will be shown", - "scope": "window" - }, - "gitlens.heatmap.toggleMode": { - "type": "string", - "default": "file", - "enum": [ - "file", - "window" - ], - "enumDescriptions": [ - "Toggles each file individually", - "Toggles the window, i.e. all files at once" - ], - "markdownDescription": "Specifies how the gutter heatmap annotations will be toggled", - "scope": "window" - }, - "gitlens.hovers.annotations.changes": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a _changes (diff)_ hover for all lines when showing blame annotations", - "scope": "window" - }, - "gitlens.hovers.annotations.details": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a _commit details_ hover for all lines when showing blame annotations", - "scope": "window" - }, - "gitlens.hovers.annotations.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide any hovers when showing blame annotations", - "scope": "window" - }, - "gitlens.hovers.annotations.over": { - "type": "string", - "default": "line", - "enum": [ - "annotation", - "line" - ], - "enumDescriptions": [ - "Only shown when hovering over the line annotation", - "Shown when hovering anywhere over the line" - ], - "markdownDescription": "Specifies when to trigger hovers when showing blame annotations", - "scope": "window" - }, - "gitlens.hovers.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images in hovers", - "scope": "window" - }, - "gitlens.hovers.avatarSize": { - "type": "number", - "default": 32, - "markdownDescription": "Specifies the size of the avatar images in hovers", - "scope": "window" - }, - "gitlens.hovers.changesDiff": { - "type": "string", - "default": "line", - "enum": [ - "line", - "hunk" - ], - "enumDescriptions": [ - "Shows only the changes to the line", - "Shows the set of related changes" - ], - "markdownDescription": "Specifies whether to show just the changes to the line or the set of related changes in the _changes (diff)_ hover", - "scope": "window" - }, - "gitlens.hovers.currentLine.changes": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a _changes (diff)_ hover for the current line", - "scope": "window" - }, - "gitlens.hovers.currentLine.details": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide a _commit details_ hover for the current line", - "scope": "window" - }, - "gitlens.hovers.currentLine.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide any hovers for the current line", - "scope": "window" - }, - "gitlens.hovers.currentLine.over": { - "type": "string", - "default": "annotation", - "enum": [ - "annotation", - "line" - ], - "enumDescriptions": [ - "Only shown when hovering over the line annotation", - "Shown when hovering anywhere over the line" - ], - "markdownDescription": "Specifies when to trigger hovers for the current line", - "scope": "window" - }, - "gitlens.hovers.detailsMarkdownFormat": { - "type": "string", - "default": "${avatar}  __${author}__, ${ago}${' via 'pullRequest}   _(${date})_ \n\n${message}\n\n${commands}${\n\n---\n\nfootnotes}", - "markdownDescription": "Specifies the format (in markdown) of the _commit details_ hover. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.hovers.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide any hovers", - "scope": "window" - }, - "gitlens.hovers.autolinks.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to automatically link external resources in commit messages", - "scope": "window" - }, - "gitlens.hovers.autolinks.enhanced": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to lookup additional details about automatically link external resources in commit messages. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.hovers.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the hovers. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.insiders": { - "deprecationMessage": "Deprecated. Use the Insiders edition of GitLens instead", - "markdownDeprecationMessage": "Deprecated. Use the [Insiders edition](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens-insiders) of GitLens instead" - }, - "gitlens.integrations.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to enable rich integrations with any supported remote services", - "scope": "window" - }, - "gitlens.keymap": { - "type": "string", - "default": "chorded", - "enum": [ - "alternate", - "chorded", - "none" - ], - "enumDescriptions": [ - "Adds an alternate set of shortcut keys that start with `Alt` (⌥ on macOS)", - "Adds a chorded set of shortcut keys that start with `Ctrl+Alt+G` (`⌥⌘G` on macOS)", - "No shortcut keys will be added" - ], - "markdownDescription": "Specifies the keymap to use for GitLens shortcut keys", - "scope": "window" - }, - "gitlens.liveshare.allowGuestAccess": { - "type": "boolean", - "default": true, - "description": "Specifies whether to allow guest access to GitLens features when using Visual Studio Live Share", - "scope": "window" - }, - "gitlens.menus": { - "anyOf": [ - { + "Sorts commands by name", + "Sorts commands by last used date" + ], + "markdownDescription": "Specifies how Git commands are sorted in the _Git Command Palette_", + "scope": "window", + "order": 10 + }, + "gitlens.gitCommands.skipConfirmations": { + "type": "array", + "default": [ + "fetch:command", + "stash-push:command", + "switch:command" + ], + "items": { + "type": "string", "enum": [ - false + "branch-create:command", + "branch-create:menu", + "co-authors:command", + "co-authors:menu", + "fetch:command", + "fetch:menu", + "pull:command", + "pull:menu", + "push:command", + "push:menu", + "stash-apply:command", + "stash-apply:menu", + "stash-pop:command", + "stash-pop:menu", + "stash-push:command", + "stash-push:menu", + "switch:command", + "switch:menu", + "tag-create:command", + "tag-create:menu" + ], + "enumDescriptions": [ + "Skips branch create confirmations when run from a command, e.g. a view action", + "Skips branch create confirmations when run from the Git Command Palette", + "Skips co-author confirmations when run from a command, e.g. a view action", + "Skips co-author confirmations when run from the Git Command Palette", + "Skips fetch confirmations when run from a command, e.g. a view action", + "Skips fetch confirmations when run from the Git Command Palette", + "Skips pull confirmations when run from a command, e.g. a view action", + "Skips pull confirmations when run from the Git Command Palette", + "Skips push confirmations when run from a command, e.g. a view action", + "Skips push confirmations when run from the Git Command Palette", + "Skips stash apply confirmations when run from a command, e.g. a view action", + "Skips stash apply confirmations when run from the Git Command Palette", + "Skips stash pop confirmations when run from a command, e.g. a view action", + "Skips stash pop confirmations when run from the Git Command Palette", + "Skips stash push confirmations when run from a command, e.g. a view action", + "Skips stash push confirmations when run from the Git Command Palette", + "Skips switch confirmations when run from a command, e.g. a view action", + "Skips switch confirmations when run from the Git Command Palette", + "Skips tag create confirmations when run from a command, e.g. a view action", + "Skips tag create confirmations when run from the Git Command Palette" ] }, - { + "minItems": 0, + "maxItems": 14, + "uniqueItems": true, + "markdownDescription": "Specifies which (and when) Git commands will skip the confirmation step, using the format: `git-command-name:(menu|command)`", + "scope": "window", + "order": 20 + }, + "gitlens.gitCommands.closeOnFocusOut": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to dismiss the _Git Command Palette_ when focus is lost (if not, press `ESC` to dismiss)", + "scope": "window", + "order": 30 + }, + "gitlens.gitCommands.search.showResultsInSideBar": { + "type": [ + "boolean", + "null" + ], + "default": null, + "markdownDescription": "Specifies whether to show the commit search results directly in the quick pick menu, in the Side Bar, or will be based on the context", + "scope": "window", + "order": 40 + }, + "gitlens.gitCommands.search.matchAll": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to match all or any commit message search patterns", + "scope": "window", + "order": 50 + }, + "gitlens.gitCommands.search.matchCase": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to match commit search patterns with or without regard to casing", + "scope": "window", + "order": 51 + }, + "gitlens.gitCommands.search.matchRegex": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to match commit search patterns using regular expressions", + "scope": "window", + "order": 52 + }, + "gitlens.gitCommands.search.showResultsInView": { + "deprecationMessage": "Deprecated. This setting has been renamed to gitlens.gitCommands.search.showResultsInSideBar", + "markdownDeprecationMessage": "Deprecated. This setting has been renamed to `#gitlens.gitCommands.search.showResultsInSideBar#`" + } + } + }, + { + "title": "Integrations", + "order": 111, + "properties": { + "gitlens.autolinks": { + "type": [ + "array", + "null" + ], + "default": null, + "items": { "type": "object", + "required": [ + "prefix", + "url" + ], "properties": { - "editor": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "blame": { - "type": "boolean" - }, - "clipboard": { - "type": "boolean" - }, - "compare": { - "type": "boolean" - }, - "history": { - "type": "boolean" - }, - "remote": { - "type": "boolean" - } - } - } + "prefix": { + "type": "string", + "description": "Specifies the short prefix to use to generate autolinks for the external resource" + }, + "title": { + "type": [ + "string", + "null" + ], + "default": null, + "description": "Specifies an optional title for the generated autolink. Use `` as the variable for the reference number" + }, + "url": { + "type": "string", + "description": "Specifies the url of the external resource you want to link to. Use `` as the variable for the reference number" + }, + "alphanumeric": { + "type": "boolean", + "description": "Specifies whether alphanumeric characters should be allowed in ``", + "default": false + }, + "ignoreCase": { + "type": "boolean", + "description": "Specifies whether case should be ignored when matching the prefix", + "default": false + } + }, + "additionalProperties": false + }, + "uniqueItems": true, + "markdownDescription": "Specifies autolinks to external resources in commit messages. Use `` as the variable for the reference number", + "scope": "window", + "order": 10 + }, + "gitlens.integrations.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to enable rich integrations with any supported remote services", + "scope": "window", + "order": 20 + }, + "gitlens.remotes": { + "type": [ + "array", + "null" + ], + "default": null, + "items": { + "type": "object", + "required": [ + "type" + ], + "oneOf": [ + { + "required": [ + "domain" + ] + }, + { + "required": [ + "regex" ] + } + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "Custom", + "AzureDevOps", + "Bitbucket", + "BitbucketServer", + "Gitea", + "GitHub", + "GitLab" + ], + "description": "Specifies the type of the custom remote service" + }, + "domain": { + "type": "string", + "description": "Specifies the domain name used to match this custom configuration to a Git remote" + }, + "regex": { + "type": "string", + "description": "Specifies a regular expression used to match this custom configuration to a Git remote and capture the \"domain name\" and \"path\"" + }, + "name": { + "type": "string", + "description": "Specifies an optional friendly name for the custom remote service" + }, + "protocol": { + "type": "string", + "default": "https", + "description": "Specifies an optional url protocol for the custom remote service" }, - "editorGroup": { - "anyOf": [ - { - "enum": [ - false - ] + "urls": { + "type": "object", + "required": [ + "repository", + "branches", + "branch", + "commit", + "file", + "fileInCommit", + "fileInBranch", + "fileLine", + "fileRange" + ], + "properties": { + "repository": { + "type": "string", + "markdownDescription": "Specifies the format of a respository url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path" + }, + "branches": { + "type": "string", + "markdownDescription": "Specifies the format of a branches url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${branch}` — branch" + }, + "branch": { + "type": "string", + "markdownDescription": "Specifies the format of a branch url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${branch}` — branch" + }, + "commit": { + "type": "string", + "markdownDescription": "Specifies the format of a commit url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${id}` — commit SHA" + }, + "file": { + "type": "string", + "markdownDescription": "Specifies the format of a file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${line}` — formatted line information" }, - { - "type": "object", - "properties": { - "blame": { - "type": "boolean" - }, - "compare": { - "type": "boolean" + "fileInBranch": { + "type": "string", + "markdownDescription": "Specifies the format of a branch file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${branch}` — branch\\\n`${line}` — formatted line information" + }, + "fileInCommit": { + "type": "string", + "markdownDescription": "Specifies the format of a commit file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${id}` — commit SHA\\\n`${line}` — formatted line information" + }, + "fileLine": { + "type": "string", + "markdownDescription": "Specifies the format of a line in a file url for the custom remote service\n\nAvailable tokens\\\n`${line}` — line" + }, + "fileRange": { + "type": "string", + "markdownDescription": "Specifies the format of a range in a file url for the custom remote service\n\nAvailable tokens\\\n`${start}` — starting line\\\n`${end}` — ending line" + } + }, + "additionalProperties": false + } + } + }, + "uniqueItems": true, + "markdownDescription": "Specifies custom remote services to be matched with Git remotes to detect custom domains for built-in remote services or provide support for custom remote services", + "scope": "resource", + "order": 30 + }, + "gitlens.partners": { + "type": [ + "object", + "null" + ], + "additionalProperties": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Specifies whether the partner integration should be shown" + } + }, + "additionalProperties": true, + "description": "Specifies the configuration of a partner integration" + }, + "default": null, + "description": "Specifies the configuration of a partner integration", + "scope": "window", + "order": 40 + }, + "gitlens.liveshare.allowGuestAccess": { + "type": "boolean", + "default": true, + "description": "Specifies whether to allow guest access to GitLens features when using Visual Studio Live Share", + "scope": "window", + "order": 50 + } + } + }, + { + "title": "Terminal", + "order": 112, + "properties": { + "gitlens.terminalLinks.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to enable terminal links — autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more", + "scope": "window" + } + } + }, + { + "title": "Date & Times", + "order": 120, + "properties": { + "gitlens.defaultDateStyle": { + "type": "string", + "default": "relative", + "enum": [ + "relative", + "absolute" + ], + "enumDescriptions": [ + "e.g. 1 day ago", + "e.g. July 25th, 2018 7:18pm" + ], + "markdownDescription": "Specifies how dates will be displayed by default", + "scope": "window", + "order": 10 + }, + "gitlens.defaultDateFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 20 + }, + "gitlens.defaultDateShortFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how short absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 21 + }, + "gitlens.defaultTimeFormat": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies how times will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", + "scope": "window", + "order": 30 + }, + "gitlens.defaultDateSource": { + "type": "string", + "default": "authored", + "enum": [ + "authored", + "committed" + ], + "enumDescriptions": [ + "Uses the date when the changes were authored (i.e. originally written)", + "Uses the date when the changes were committed" + ], + "markdownDescription": "Specifies whether commit dates should use the authored or committed date", + "scope": "window", + "order": 40 + } + } + }, + { + "title": "Menus & Toolbars", + "order": 121, + "properties": { + "gitlens.menus": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "editor": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "blame": { + "type": "boolean" + }, + "clipboard": { + "type": "boolean" + }, + "compare": { + "type": "boolean" + }, + "history": { + "type": "boolean" + }, + "remote": { + "type": "boolean" + } + } + } + ] + }, + "editorGroup": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "blame": { + "type": "boolean" + }, + "compare": { + "type": "boolean" + } } } - } - ] - }, - "editorTab": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "clipboard": { - "type": "boolean" - }, - "compare": { - "type": "boolean" - }, - "history": { - "type": "boolean" - }, - "remote": { - "type": "boolean" + ] + }, + "editorTab": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "clipboard": { + "type": "boolean" + }, + "compare": { + "type": "boolean" + }, + "history": { + "type": "boolean" + }, + "remote": { + "type": "boolean" + } } } - } - ] - }, - "explorer": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "clipboard": { - "type": "boolean" - }, - "compare": { - "type": "boolean" - }, - "history": { - "type": "boolean" - }, - "remote": { - "type": "boolean" + ] + }, + "explorer": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "clipboard": { + "type": "boolean" + }, + "compare": { + "type": "boolean" + }, + "history": { + "type": "boolean" + }, + "remote": { + "type": "boolean" + } } } - } - ] - }, - "scm": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "authors": { - "type": "boolean" + ] + }, + "scm": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "authors": { + "type": "boolean" + } } } - } - ] - }, - "scmGroupInline": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "stash": { - "type": "boolean" + ] + }, + "scmGroupInline": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "stash": { + "type": "boolean" + } } } - } - ] - }, - "scmGroup": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "compare": { - "type": "boolean" - }, - "openClose": { - "type": "boolean" - }, - "stash": { - "type": "boolean" + ] + }, + "scmGroup": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "compare": { + "type": "boolean" + }, + "openClose": { + "type": "boolean" + }, + "stash": { + "type": "boolean" + } } } - } - ] - }, - "scmItem": { - "anyOf": [ - { - "enum": [ - false - ] - }, - { - "type": "object", - "properties": { - "clipboard": { - "type": "boolean" - }, - "compare": { - "type": "boolean" - }, - "history": { - "type": "boolean" - }, - "remote": { - "type": "boolean" - }, - "stash": { - "type": "boolean" + ] + }, + "scmItem": { + "anyOf": [ + { + "enum": [ + false + ] + }, + { + "type": "object", + "properties": { + "clipboard": { + "type": "boolean" + }, + "compare": { + "type": "boolean" + }, + "history": { + "type": "boolean" + }, + "remote": { + "type": "boolean" + }, + "stash": { + "type": "boolean" + } } } - } - ] - } + ] + } + }, + "additionalProperties": false + } + ], + "default": { + "editor": { + "blame": false, + "clipboard": true, + "compare": true, + "history": false, + "remote": false }, - "additionalProperties": false - } - ], - "default": { - "editor": { - "blame": false, - "clipboard": true, - "compare": true, - "history": false, - "remote": false - }, - "editorGroup": { - "blame": true, - "compare": true - }, - "editorTab": { - "clipboard": true, - "compare": true, - "history": true, - "remote": true - }, - "explorer": { - "clipboard": true, - "compare": true, - "history": true, - "remote": true - }, - "scm": { - "authors": true - }, - "scmGroupInline": { - "stash": true - }, - "scmGroup": { - "compare": true, - "openClose": true, - "stash": true + "editorGroup": { + "blame": true, + "compare": true + }, + "editorTab": { + "clipboard": true, + "compare": true, + "history": true, + "remote": true + }, + "explorer": { + "clipboard": true, + "compare": true, + "history": true, + "remote": true + }, + "scm": { + "authors": true + }, + "scmGroupInline": { + "stash": true + }, + "scmGroup": { + "compare": true, + "openClose": true, + "stash": true + }, + "scmItem": { + "clipboard": true, + "compare": true, + "history": true, + "remote": false, + "stash": true + } }, - "scmItem": { - "clipboard": true, - "compare": true, - "history": true, - "remote": false, - "stash": true - } - }, - "markdownDescription": "Specifies which commands will be added to which menus", - "scope": "window" - }, - "gitlens.mode.active": { - "type": "string", - "markdownDescription": "Specifies the active GitLens mode, if any", - "scope": "window" - }, - "gitlens.mode.statusBar.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide the active GitLens mode in the status bar", - "scope": "window" - }, - "gitlens.mode.statusBar.alignment": { - "type": "string", - "default": "right", - "enum": [ - "left", - "right" - ], - "enumDescriptions": [ - "Aligns to the left", - "Aligns to the right" - ], - "markdownDescription": "Specifies the active GitLens mode alignment in the status bar", - "scope": "window" - }, - "gitlens.modes": { - "type": "object", - "properties": { - "zen": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "Specifies the friendly name of this user-defined mode" - }, - "statusBarItemName": { - "type": "string", - "description": "Specifies the name shown in the status bar when this user-defined mode is active" - }, - "description": { - "type": "string", - "description": "Specifies the description of this user-defined mode" - }, - "codeLens": { - "type": "boolean", - "description": "Specifies whether to show any Git code lens when this user-defined mode is active" - }, - "currentLine": { - "type": "boolean", - "description": "Specifies whether to show a blame annotation for the current line when this user-defined mode is active" - }, - "hovers": { - "type": "boolean", - "description": "Specifies whether to show any hovers when this user-defined mode is active" - }, - "statusBar": { - "type": "boolean", - "description": "Specifies whether to show blame information in the status bar when this user-defined mode is active" + "markdownDescription": "Specifies which commands will be added to which menus", + "scope": "window", + "order": 10 + } + } + }, + { + "title": "Keyboard Shortcuts", + "order": 122, + "properties": { + "gitlens.keymap": { + "type": "string", + "default": "chorded", + "enum": [ + "alternate", + "chorded", + "none" + ], + "enumDescriptions": [ + "Adds an alternate set of shortcut keys that start with `Alt` (⌥ on macOS)", + "Adds a chorded set of shortcut keys that start with `Ctrl+Alt+G` (`⌥⌘G` on macOS)", + "No shortcut keys will be added" + ], + "markdownDescription": "Specifies the keymap to use for GitLens shortcut keys", + "scope": "window", + "order": 10 + } + } + }, + { + "title": "Modes", + "order": 123, + "properties": { + "gitlens.mode.statusBar.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to provide the active GitLens mode in the status bar", + "scope": "window", + "order": 10 + }, + "gitlens.mode.statusBar.alignment": { + "type": "string", + "default": "right", + "enum": [ + "left", + "right" + ], + "enumDescriptions": [ + "Aligns to the left", + "Aligns to the right" + ], + "markdownDescription": "Specifies the active GitLens mode alignment in the status bar", + "scope": "window", + "order": 11 + }, + "gitlens.mode.active": { + "type": "string", + "markdownDescription": "Specifies the active GitLens mode, if any", + "scope": "window", + "order": 20 + }, + "gitlens.modes": { + "type": "object", + "properties": { + "zen": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "Specifies the friendly name of this user-defined mode" + }, + "statusBarItemName": { + "type": "string", + "description": "Specifies the name shown in the status bar when this user-defined mode is active" + }, + "description": { + "type": "string", + "description": "Specifies the description of this user-defined mode" + }, + "codeLens": { + "type": "boolean", + "description": "Specifies whether to show any Git code lens when this user-defined mode is active" + }, + "currentLine": { + "type": "boolean", + "description": "Specifies whether to show a blame annotation for the current line when this user-defined mode is active" + }, + "hovers": { + "type": "boolean", + "description": "Specifies whether to show any hovers when this user-defined mode is active" + }, + "statusBar": { + "type": "boolean", + "description": "Specifies whether to show blame information in the status bar when this user-defined mode is active" + } + } + }, + "review": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "Specifies the friendly name of this user-defined mode" + }, + "statusBarItemName": { + "type": "string", + "description": "Specifies the name shown in the status bar when this user-defined mode is active" + }, + "description": { + "type": "string", + "description": "Specifies the description of this user-defined mode" + }, + "codeLens": { + "type": "boolean", + "description": "Specifies whether to show any Git code lens when this user-defined mode is active" + }, + "currentLine": { + "type": "boolean", + "description": "Specifies whether to show a blame annotation for the current line when this user-defined mode is active" + }, + "hovers": { + "type": "boolean", + "description": "Specifies whether to show any hovers when this user-defined mode is active" + }, + "statusBar": { + "type": "boolean", + "description": "Specifies whether to show blame information in the status bar when this user-defined mode is active" + } } } }, - "review": { + "additionalProperties": { "type": "object", + "required": [ + "name" + ], "properties": { "name": { "type": "string", @@ -1320,6 +2686,20 @@ "type": "string", "description": "Specifies the description of this user-defined mode" }, + "annotations": { + "type": "string", + "enum": [ + "blame", + "changes", + "heatmap" + ], + "enumDescriptions": [ + "Shows the gutter blame annotations", + "Shows the gutter changes annotations", + "Shows the gutter heatmap annotations" + ], + "description": "Specifies which (if any) file annotations will be shown when this user-defined mode is active" + }, "codeLens": { "type": "boolean", "description": "Specifies whether to show any Git code lens when this user-defined mode is active" @@ -1337,1371 +2717,356 @@ "description": "Specifies whether to show blame information in the status bar when this user-defined mode is active" } } - } - }, - "additionalProperties": { + }, + "default": { + "zen": { + "name": "Zen", + "statusBarItemName": "Zen", + "description": "for a zen-like experience, disables many visual features", + "codeLens": false, + "currentLine": false, + "hovers": false, + "statusBar": false + }, + "review": { + "name": "Review", + "statusBarItemName": "Reviewing", + "description": "for reviewing code, enables many visual features", + "codeLens": true, + "currentLine": true, + "hovers": true + } + }, + "markdownDescription": "Specifies the user-defined GitLens modes", + "scope": "window", + "order": 30 + } + } + }, + { + "title": "Advanced", + "order": 1000, + "properties": { + "gitlens.advanced.messages": { "type": "object", - "required": [ - "name" - ], + "default": { + "suppressCommitHasNoPreviousCommitWarning": false, + "suppressCommitNotFoundWarning": false, + "suppressCreatePullRequestPrompt": false, + "suppressDebugLoggingWarning": false, + "suppressFileNotUnderSourceControlWarning": false, + "suppressGitDisabledWarning": false, + "suppressGitMissingWarning": false, + "suppressGitVersionWarning": false, + "suppressImproperWorkspaceCasingWarning": false, + "suppressLineUncommittedWarning": false, + "suppressNoRepositoryWarning": false, + "suppressRebaseSwitchToTextWarning": false + }, "properties": { - "name": { - "type": "string", - "description": "Specifies the friendly name of this user-defined mode" - }, - "statusBarItemName": { - "type": "string", - "description": "Specifies the name shown in the status bar when this user-defined mode is active" - }, - "description": { - "type": "string", - "description": "Specifies the description of this user-defined mode" - }, - "annotations": { - "type": "string", - "enum": [ - "blame", - "changes", - "heatmap" - ], - "enumDescriptions": [ - "Shows the gutter blame annotations", - "Shows the gutter changes annotations", - "Shows the gutter heatmap annotations" - ], - "description": "Specifies which (if any) file annotations will be shown when this user-defined mode is active" + "suppressCommitHasNoPreviousCommitWarning": { + "type": "boolean", + "default": false, + "description": "Commit Has No Previous Commit Warning" }, - "codeLens": { + "suppressCommitNotFoundWarning": { "type": "boolean", - "description": "Specifies whether to show any Git code lens when this user-defined mode is active" + "default": false, + "description": "Commit Not Found Warning" }, - "currentLine": { + "suppressCreatePullRequestPrompt": { "type": "boolean", - "description": "Specifies whether to show a blame annotation for the current line when this user-defined mode is active" + "default": false, + "description": "Create Pull Request Prompt" }, - "hovers": { + "suppressDebugLoggingWarning": { "type": "boolean", - "description": "Specifies whether to show any hovers when this user-defined mode is active" + "default": false, + "description": "Debug Logging Warning" }, - "statusBar": { + "suppressFileNotUnderSourceControlWarning": { "type": "boolean", - "description": "Specifies whether to show blame information in the status bar when this user-defined mode is active" - } - } - }, - "default": { - "zen": { - "name": "Zen", - "statusBarItemName": "Zen", - "description": "for a zen-like experience, disables many visual features", - "codeLens": false, - "currentLine": false, - "hovers": false, - "statusBar": false - }, - "review": { - "name": "Review", - "statusBarItemName": "Reviewing", - "description": "for reviewing code, enables many visual features", - "codeLens": true, - "currentLine": true, - "hovers": true - } - }, - "markdownDescription": "Specifies the user-defined GitLens modes", - "scope": "window" - }, - "gitlens.outputLevel": { - "type": "string", - "default": "errors", - "enum": [ - "silent", - "errors", - "verbose", - "debug" - ], - "enumDescriptions": [ - "Logs nothing", - "Logs only errors", - "Logs all errors, warnings, and messages", - "Logs all errors, warnings, and messages with extra context useful for debugging" - ], - "markdownDescription": "Specifies how much (if any) output will be sent to the GitLens output channel", - "scope": "window" - }, - "gitlens.partners": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "object", - "properties": { - "enabled": { + "default": false, + "description": "File Not Under Source Control Warning" + }, + "suppressGitDisabledWarning": { "type": "boolean", - "default": true, - "description": "Specifies whether the partner integration should be shown" - } - }, - "additionalProperties": true, - "description": "Specifies the configuration of a partner integration" - }, - "default": null, - "description": "Specifies the configuration of a partner integration", - "scope": "window" - }, - "gitlens.remotes": { - "type": [ - "array", - "null" - ], - "default": null, - "items": { - "type": "object", - "required": [ - "type" - ], - "oneOf": [ - { - "required": [ - "domain" - ] + "default": false, + "description": "Git Disabled Warning" }, - { - "required": [ - "regex" - ] - } - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "Custom", - "AzureDevOps", - "Bitbucket", - "BitbucketServer", - "Gitea", - "GitHub", - "GitLab" - ], - "description": "Specifies the type of the custom remote service" + "suppressGitMissingWarning": { + "type": "boolean", + "default": false, + "description": "Git Missing Warning" }, - "domain": { - "type": "string", - "description": "Specifies the domain name used to match this custom configuration to a Git remote" + "suppressGitVersionWarning": { + "type": "boolean", + "default": false, + "description": "Git Version Warning" }, - "regex": { - "type": "string", - "description": "Specifies a regular expression used to match this custom configuration to a Git remote and capture the \"domain name\" and \"path\"" + "suppressImproperWorkspaceCasingWarning": { + "type": "boolean", + "default": false, + "description": "Improper Workspace Casing Warning" }, - "name": { - "type": "string", - "description": "Specifies an optional friendly name for the custom remote service" + "suppressLineUncommittedWarning": { + "type": "boolean", + "default": false, + "description": "Line Uncommitted Warning" }, - "protocol": { - "type": "string", - "default": "https", - "description": "Specifies an optional url protocol for the custom remote service" + "suppressNoRepositoryWarning": { + "type": "boolean", + "default": false, + "description": "No Repository Warning" }, - "urls": { - "type": "object", - "required": [ - "repository", - "branches", - "branch", - "commit", - "file", - "fileInCommit", - "fileInBranch", - "fileLine", - "fileRange" - ], - "properties": { - "repository": { - "type": "string", - "markdownDescription": "Specifies the format of a respository url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path" - }, - "branches": { - "type": "string", - "markdownDescription": "Specifies the format of a branches url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${branch}` — branch" - }, - "branch": { - "type": "string", - "markdownDescription": "Specifies the format of a branch url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${branch}` — branch" - }, - "commit": { - "type": "string", - "markdownDescription": "Specifies the format of a commit url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${id}` — commit SHA" - }, - "file": { - "type": "string", - "markdownDescription": "Specifies the format of a file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${line}` — formatted line information" - }, - "fileInBranch": { - "type": "string", - "markdownDescription": "Specifies the format of a branch file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${branch}` — branch\\\n`${line}` — formatted line information" - }, - "fileInCommit": { - "type": "string", - "markdownDescription": "Specifies the format of a commit file url for the custom remote service\n\nAvailable tokens\\\n`${repo}` — repository path\\\n`${file}` — file name\\\n`${id}` — commit SHA\\\n`${line}` — formatted line information" - }, - "fileLine": { - "type": "string", - "markdownDescription": "Specifies the format of a line in a file url for the custom remote service\n\nAvailable tokens\\\n`${line}` — line" - }, - "fileRange": { - "type": "string", - "markdownDescription": "Specifies the format of a range in a file url for the custom remote service\n\nAvailable tokens\\\n`${start}` — starting line\\\n`${end}` — ending line" - } - }, - "additionalProperties": false + "suppressRebaseSwitchToTextWarning": { + "type": "boolean", + "default": false, + "description": "Rebase Switch To Text Warning" } - } - }, - "uniqueItems": true, - "markdownDescription": "Specifies custom remote services to be matched with Git remotes to detect custom domains for built-in remote services or provide support for custom remote services", - "scope": "resource" - }, - "gitlens.showWelcomeOnInstall": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the Welcome (Quick Setup) experience on first install", - "scope": "window" - }, - "gitlens.showWhatsNewAfterUpgrades": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the What's New notification after upgrading to new feature releases", - "scope": "window" - }, - "gitlens.sortBranchesBy": { - "type": "string", - "default": "date:desc", - "enum": [ - "date:desc", - "date:asc", - "name:asc", - "name:desc" - ], - "enumDescriptions": [ - "Sorts branches by the most recent commit date in descending order", - "Sorts branches by the most recent commit date in ascending order", - "Sorts branches by name in ascending order", - "Sorts branches by name in descending order" - ], - "markdownDescription": "Specifies how branches are sorted in quick pick menus and views", - "scope": "window" - }, - "gitlens.sortContributorsBy": { - "type": "string", - "default": "count:desc", - "enum": [ - "count:desc", - "count:asc", - "date:desc", - "date:asc", - "name:asc", - "name:desc" - ], - "enumDescriptions": [ - "Sorts contributors by commit count in descending order", - "Sorts contributors by commit count in ascending order", - "Sorts contributors by the most recent commit date in descending order", - "Sorts contributors by the most recent commit date in ascending order", - "Sorts contributors by name in ascending order", - "Sorts contributors by name in descending order" - ], - "markdownDescription": "Specifies how contributors are sorted in quick pick menus and views", - "scope": "window" - }, - "gitlens.sortTagsBy": { - "type": "string", - "default": "date:desc", - "enum": [ - "date:desc", - "date:asc", - "name:asc", - "name:desc" - ], - "enumDescriptions": [ - "Sorts tags by date in descending order", - "Sorts tags by date in ascending order", - "Sorts tags by name in ascending order", - "Sorts tags by name in descending order" - ], - "markdownDescription": "Specifies how tags are sorted in quick pick menus and views", - "scope": "window" - }, - "gitlens.statusBar.alignment": { - "type": "string", - "default": "right", - "enum": [ - "left", - "right" - ], - "enumDescriptions": [ - "Aligns to the left", - "Aligns to the right" - ], - "markdownDescription": "Specifies the blame alignment in the status bar", - "scope": "window" - }, - "gitlens.statusBar.command": { - "type": "string", - "default": "gitlens.showQuickCommitDetails", - "enum": [ - "gitlens.toggleFileBlame", - "gitlens.toggleFileHeatmap", - "gitlens.toggleFileChanges", - "gitlens.toggleFileChangesOnly", - "gitlens.toggleCodeLens", - "gitlens.diffWithPrevious", - "gitlens.diffWithWorking", - "gitlens.revealCommitInView", - "gitlens.showCommitsInView", - "gitlens.showQuickCommitDetails", - "gitlens.showQuickCommitFileDetails", - "gitlens.showQuickFileHistory", - "gitlens.showQuickRepoHistory", - "gitlens.openCommitOnRemote", - "gitlens.copyRemoteCommitUrl", - "gitlens.openFileOnRemote", - "gitlens.copyRemoteFileUrl" - ], - "enumDescriptions": [ - "Toggles file blame", - "Toggles file heatmap", - "Toggles file changes since before the commit", - "Toggles file changes from the commit", - "Toggles Git code lens", - "Compares the current line commit with the previous", - "Compares the current line commit with the working tree", - "Reveals the commit in the Side Bar", - "Searches for the commit", - "Shows a commit details quick pick menu", - "Shows a commit file details quick pick menu", - "Shows a file history quick pick menu", - "Shows a branch history quick pick menu", - "Opens the commit on the remote service (when available)", - "Copies the remote commit url to the clipboard (when available)", - "Opens the file revision on the remote service (when available)", - "Copies the remote file url to the clipboard (when available)" - ], - "markdownDescription": "Specifies the command to be executed when the blame status bar item is clicked", - "scope": "window" - }, - "gitlens.statusBar.dateFormat": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies how to format absolute dates (e.g. using the `${date}` token) in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats", - "scope": "window" - }, - "gitlens.statusBar.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide blame information in the status bar", - "scope": "window" - }, - "gitlens.statusBar.format": { - "type": "string", - "default": "${author}, ${agoOrDate}${' via 'pullRequest}", - "markdownDescription": "Specifies the format of the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `#gitlens.statusBar.dateFormat#` setting", - "scope": "window" - }, - "gitlens.statusBar.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the status bar. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.statusBar.reduceFlicker": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar \"flashing\"", - "scope": "window" - }, - "gitlens.statusBar.tooltipFormat": { - "type": "string", - "default": "${avatar}  __${author}__, ${ago}${' via 'pullRequest}   _(${date})_ \n\n${message}\n\n${commands}${\n\n---\n\nfootnotes}", - "markdownDescription": "Specifies the format (in markdown) of hover shown over the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors": { - "type": "string", - "default": "$(ellipsis)", - "markdownDescription": "Specifies the string to be shown in place of both the _recent change_ and _authors_ code lens when there are unsaved changes", - "scope": "window" - }, - "gitlens.strings.codeLens.unsavedChanges.recentChangeOnly": { - "type": "string", - "default": "$(ellipsis)", - "markdownDescription": "Specifies the string to be shown in place of the _recent change_ code lens when there are unsaved changes", - "scope": "window" - }, - "gitlens.strings.codeLens.unsavedChanges.authorsOnly": { - "type": "string", - "default": "$(ellipsis)", - "markdownDescription": "Specifies the string to be shown in place of the _authors_ code lens when there are unsaved changes", - "scope": "window" - }, - "gitlens.terminalLinks.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to enable terminal links — autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more", - "scope": "window" - }, - "gitlens.views.branches.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Branches_ view", - "scope": "window" - }, - "gitlens.views.branches.branches.layout": { - "type": "string", - "default": "tree", - "enum": [ - "list", - "tree" - ], - "enumDescriptions": [ - "Displays branches as a list", - "Displays branches as a tree when branch names contain slashes `/`" - ], - "markdownDescription": "Specifies how the _Branches_ view will display branches", - "scope": "window" - }, - "gitlens.views.branches.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Branches_ view. Only applies when `#gitlens.views.branches.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.branches.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.branches.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Branches_ view will display files", - "scope": "window" - }, - "gitlens.views.branches.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Branches_ view. Only applies when `#gitlens.views.branches.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.branches.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.branches.pullRequests.showForBranches": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.branches.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Branches_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.branches.reveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to reveal branches in the _Branches_ view, otherwise they revealed in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.branches.showBranchComparison": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "branch" - ], - "enumDescriptions": [ - "Hides the branch comparison", - "Compares the branch with a user-selected reference" - ], - "default": "branch", - "markdownDescription": "Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) in the _Branches_ view", - "scope": "window" - }, - "gitlens.views.commitFileFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" - }, - "gitlens.views.commitFileDescriptionFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" - }, - "gitlens.views.commitFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.commits.label` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.commits.files.label#` instead" - }, - "gitlens.views.commitDescriptionFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.commits.description` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.commits.description#` instead" - }, - "gitlens.views.commits.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Commits_ view", - "scope": "window" - }, - "gitlens.views.commits.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Commits_ view. Only applies when `#gitlens.views.commits.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.commits.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.commits.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Commits_ view will display files", - "scope": "window" - }, - "gitlens.views.commits.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Commits_ view. Only applies when `#gitlens.views.commits.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.commits.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with the current branch and commits in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.commits.pullRequests.showForBranches": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with the current branch in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.commits.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Commits_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.commits.reveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to reveal commits in the _Commits_ view, otherwise they revealed in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.commits.showBranchComparison": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "branch", - "working" - ], - "enumDescriptions": [ - "Hides the branch comparison", - "Compares the current branch with a user-selected reference", - "Compares the working tree with a user-selected reference" - ], - "default": "working", - "markdownDescription": "Specifies whether to show a comparison of the current branch or the working tree with a user-selected reference (branch, tag. etc) in the _Commits_ view", - "scope": "window" - }, - "gitlens.views.contributors.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Contributors_ view", - "scope": "window" - }, - "gitlens.views.contributors.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Contributors_ view. Only applies when `#gitlens.views.contributors.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.contributors.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.contributors.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Contributors_ view will display files", - "scope": "window" - }, - "gitlens.views.contributors.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Contributors_ view. Only applies when `#gitlens.views.contributors.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.contributors.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Contributors_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.contributors.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Contributors_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.contributors.showAllBranches": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to show commits from all branches in the _Contributors_ view", - "scope": "window" - }, - "gitlens.views.contributors.showStatistics": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to show contributor statistics in the _Contributors_ view. This can take a while to compute depending on the repository size", - "scope": "window" - }, - "gitlens.views.defaultItemLimit": { - "type": "number", - "default": 10, - "markdownDescription": "Specifies the default number of items to show in a view list. Use 0 to specify no limit", - "scope": "window" - }, - "gitlens.views.formats.commits.label": { - "type": "string", - "default": "${❰ tips ❱➤ }${message}", - "markdownDescription": "Specifies the format of commits in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.formats.commits.description": { - "type": "string", - "default": "${author, }${agoOrDate}", - "markdownDescription": "Specifies the description format of commits in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.formats.files.label": { - "type": "string", - "default": "${working }${file}", - "markdownDescription": "Specifies the format of a file in the views. See [_File Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#file-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.formats.files.description": { - "type": "string", - "default": "${directory}${ ← originalPath}", - "markdownDescription": "Specifies the description format of a file in the views. See [_File Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#file-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.formats.stashes.label": { - "type": "string", - "default": "${message}", - "markdownDescription": "Specifies the format of stashes in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.formats.stashes.description": { - "type": "string", - "default": "${agoOrDate}", - "markdownDescription": "Specifies the description format of stashes in the views. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs", - "scope": "window" - }, - "gitlens.views.fileHistory.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of status icons in the _File History_ view", - "scope": "window" - }, - "gitlens.views.fileHistory.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _File History_ view. Only applies to folder history and when `#gitlens.views.fileHistory.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.fileHistory.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.fileHistory.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _File History_ view will display files when showing the history of a folder", - "scope": "window" - }, - "gitlens.views.fileHistory.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _File History_ view. Only applies to folder history and when `#gitlens.views.fileHistory.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.lineHistory.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of status icons in the _Line History_ view", - "scope": "window" - }, - "gitlens.views.lineHistory.enabled": { - "deprecationMessage": "Deprecated. This setting is no longer used", - "markdownDeprecationMessage": "Deprecated. This setting is no longer used" - }, - "gitlens.views.pageItemLimit": { - "type": "number", - "default": 40, - "markdownDescription": "Specifies the number of items to show in a each page when paginating a view list. Use 0 to specify no limit", - "scope": "window" - }, - "gitlens.views.remotes.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Remotes_ view", - "scope": "window" - }, - "gitlens.views.remotes.branches.layout": { - "type": "string", - "default": "tree", - "enum": [ - "list", - "tree" - ], - "enumDescriptions": [ - "Displays branches as a list", - "Displays branches as a tree when branch names contain slashes `/`" - ], - "markdownDescription": "Specifies how the _Remotes_ view will display branches", - "scope": "window" - }, - "gitlens.views.remotes.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Remotes_ view. Only applies when `#gitlens.views.remotes.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.remotes.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.remotes.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Remotes_ view will display files", - "scope": "window" - }, - "gitlens.views.remotes.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Remotes_ view. Only applies when `#gitlens.views.remotes.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.remotes.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.remotes.pullRequests.showForBranches": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.remotes.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Remotes_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.remotes.reveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to reveal remotes in the _Remotes_ view, otherwise they revealed in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.autoRefresh": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to automatically refresh the _Repositories_ view when the repository or the file system changes", - "scope": "window" - }, - "gitlens.views.repositories.autoReveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to automatically reveal repositories in the _Repositories_ view when opening files", - "scope": "window" - }, - "gitlens.views.repositories.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.branches.layout": { - "type": "string", - "default": "tree", - "enum": [ - "list", - "tree" - ], - "enumDescriptions": [ - "Displays branches as a list", - "Displays branches as a tree when branch names contain slashes `/`" - ], - "markdownDescription": "Specifies how the _Repositories_ view will display branches", - "scope": "window" - }, - "gitlens.views.repositories.branches.showBranchComparison": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "branch" - ], - "enumDescriptions": [ - "Hides the branch comparison", - "Compares the branch with a user-selected reference" - ], - "default": "branch", - "markdownDescription": "Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) under each branch in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.compact": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to show the _Repositories_ view in a compact display density", - "scope": "window" - }, - "gitlens.views.repositories.enabled": { - "deprecationMessage": "Deprecated. This setting is no longer used", - "markdownDeprecationMessage": "Deprecated. This setting is no longer used" - }, - "gitlens.views.repositories.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Repositories_ view. Only applies when `#gitlens.views.repositories.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.repositories.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.repositories.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Repositories_ view will display files", - "scope": "window" - }, - "gitlens.views.repositories.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Repositories_ view. Only applies when `#gitlens.views.repositories.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.repositories.includeWorkingTree": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to include working tree file status for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with branches and commits in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.repositories.pullRequests.showForBranches": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with branches in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.repositories.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Repositories_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.repositories.showBranchComparison": { - "type": [ - "boolean", - "string" - ], - "enum": [ - false, - "branch", - "working" - ], - "enumDescriptions": [ - "Hides the branch comparison", - "Compares the current branch with a user-selected reference", - "Compares the working tree with a user-selected reference" - ], - "default": "working", - "markdownDescription": "Specifies whether to show a comparison of the current branch or the working tree with a user-selected reference (branch, tag. etc) in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showBranches": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the branches for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the commits on the current branch for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showContributors": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the contributors for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showIncomingActivity": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to show the experimental incoming activity for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showRemotes": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the remotes for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showStashes": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the stashes for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showTags": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the tags for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.repositories.showUpstreamStatus": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show the upstream status of the current branch for each repository in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.searchAndCompare.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Search & Compare_ view", - "scope": "window" - }, - "gitlens.views.searchAndCompare.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Search & Compare_ view. Only applies when `#gitlens.views.searchAndCompare.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.searchAndCompare.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.searchAndCompare.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Search & Compare_ view will display files", - "scope": "window" - }, - "gitlens.views.searchAndCompare.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Search & Compare_ view. Only applies when `#gitlens.views.searchAndCompare.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.searchAndCompare.pullRequests.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to query for pull requests associated with commits in the _Search & Compare_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.searchAndCompare.pullRequests.showForCommits": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show pull requests (if any) associated with commits in the _Search & Compare_ view. Requires a connection to a supported remote service (e.g. GitHub)", - "scope": "window" - }, - "gitlens.views.showRelativeDateMarkers": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show relative date markers (_Less than a week ago_, _Over a week ago_, _Over a month ago_, etc) on revision (commit) histories in the views", - "scope": "window" - }, - "gitlens.views.stashFileFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" - }, - "gitlens.views.stashFileDescriptionFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" - }, - "gitlens.views.stashFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.stashes.label` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.stashes.files.label#` instead" - }, - "gitlens.views.stashDescriptionFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.stashes.description` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.stashes.description#` instead" - }, - "gitlens.views.stashes.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Stashes_ view. Only applies when `#gitlens.views.stashes.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.stashes.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.stashes.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Stashes_ view will display files", - "scope": "window" - }, - "gitlens.views.stashes.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Stashes_ view. Only applies when `#gitlens.views.stashes.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.stashes.reveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to reveal stashes in the _Stashes_ view, otherwise they revealed in the _Repositories_ view", - "scope": "window" - }, - "gitlens.views.statusFileFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.label` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.label#` instead" - }, - "gitlens.views.statusFileDescriptionFormat": { - "deprecationMessage": "Deprecated. Use `gitlens.views.formats.files.description` instead", - "markdownDeprecationMessage": "Deprecated. Use `#gitlens.views.formats.files.description#` instead" - }, - "gitlens.views.tags.avatars": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to show avatar images instead of commit (or status) icons in the _Tags_ view", - "scope": "window" - }, - "gitlens.views.tags.branches.layout": { - "type": "string", - "default": "tree", - "enum": [ - "list", - "tree" - ], - "enumDescriptions": [ - "Displays tags as a list", - "Displays tags as a tree when tags names contain slashes `/`" - ], - "markdownDescription": "Specifies how the _Tags_ view will display tags", - "scope": "window" - }, - "gitlens.views.tags.files.compact": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to compact (flatten) unnecessary file nesting in the _Tags_ view. Only applies when `#gitlens.views.tags.files.layout#` is set to `tree` or `auto`", - "scope": "window" - }, - "gitlens.views.tags.files.layout": { - "type": "string", - "default": "auto", - "enum": [ - "auto", - "list", - "tree" - ], - "enumDescriptions": [ - "Automatically switches between displaying files as a `tree` or `list` based on the `#gitlens.views.tags.files.threshold#` value and the number of files at each nesting level", - "Displays files as a list", - "Displays files as a tree" - ], - "markdownDescription": "Specifies how the _Tags_ view will display files", - "scope": "window" - }, - "gitlens.views.tags.files.threshold": { - "type": "number", - "default": 5, - "markdownDescription": "Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Tags_ view. Only applies when `#gitlens.views.tags.files.layout#` is set to `auto`", - "scope": "window" - }, - "gitlens.views.tags.reveal": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to reveal tags in the _Tags_ view, otherwise they revealed in the _Repositories_ view", - "scope": "window" - }, - "gitlens.advanced.abbreviatedShaLength": { - "type": "number", - "default": 7, - "markdownDescription": "Specifies the length of abbreviated commit SHAs", - "scope": "window" - }, - "gitlens.advanced.abbreviateShaOnCopy": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether to copy full or abbreviated commit SHAs to the clipboard. Abbreviates to the length of `#gitlens.advanced.abbreviatedShaLength#`.", - "scope": "window" - }, - "gitlens.advanced.blame.customArguments": { - "type": [ - "array", - "null" - ], - "default": null, - "items": { - "type": "string" - }, - "markdownDescription": "Specifies additional arguments to pass to the `git blame` command", - "scope": "resource" - }, - "gitlens.advanced.blame.delayAfterEdit": { - "type": "number", - "default": 5000, - "markdownDescription": "Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait", - "scope": "window" - }, - "gitlens.advanced.blame.sizeThresholdAfterEdit": { - "type": "number", - "default": 5000, - "markdownDescription": "Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum", - "scope": "window" - }, - "gitlens.advanced.caching.enabled": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether git output will be cached — changing the default is not recommended", - "scope": "window" - }, - "gitlens.advanced.commitOrdering": { - "type": [ - "string", - "null" - ], - "default": null, - "enum": [ - null, - "date", - "author-date", - "topo" - ], - "enumDescriptions": [ - "Shows commits in reverse chronological order", - "Shows commits in reverse chronological order of the commit timestamp", - "Shows commits in reverse chronological order of the author timestamp", - "Shows commits in reverse chronological order of the commit timestamp, but avoids intermixing multiple lines of history" - ], - "markdownDescription": "Specifies the order by which commits will be shown. If unspecified, commits will be shown in reverse chronological order", - "scope": "window" - }, - "gitlens.advanced.externalDiffTool": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies an optional external diff tool to use when comparing files. Must be a configured [Git difftool](https://git-scm.com/docs/git-config#Documentation/git-config.txt-difftool).", - "scope": "window" - }, - "gitlens.advanced.externalDirectoryDiffTool": { - "type": [ - "string", - "null" - ], - "default": null, - "markdownDescription": "Specifies an optional external diff tool to use when comparing directories. Must be a configured [Git difftool](https://git-scm.com/docs/git-config#Documentation/git-config.txt-difftool).", - "scope": "window" - }, - "gitlens.advanced.fileHistoryFollowsRenames": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether file histories will follow renames — will affect how merge commits are shown in histories", - "scope": "window" - }, - "gitlens.advanced.fileHistoryShowAllBranches": { - "type": "boolean", - "default": false, - "markdownDescription": "Specifies whether file histories will show commits from all branches", - "scope": "window" - }, - "gitlens.advanced.maxListItems": { - "type": "number", - "default": 200, - "markdownDescription": "Specifies the maximum number of items to show in a list. Use 0 to specify no maximum", - "scope": "window" - }, - "gitlens.advanced.maxSearchItems": { - "type": "number", - "default": 200, - "markdownDescription": "Specifies the maximum number of items to show in a search. Use 0 to specify no maximum", - "scope": "window" - }, - "gitlens.advanced.messages": { - "type": "object", - "default": { - "suppressCommitHasNoPreviousCommitWarning": false, - "suppressCommitNotFoundWarning": false, - "suppressCreatePullRequestPrompt": false, - "suppressDebugLoggingWarning": false, - "suppressFileNotUnderSourceControlWarning": false, - "suppressGitDisabledWarning": false, - "suppressGitMissingWarning": false, - "suppressGitVersionWarning": false, - "suppressImproperWorkspaceCasingWarning": false, - "suppressLineUncommittedWarning": false, - "suppressNoRepositoryWarning": false, - "suppressRebaseSwitchToTextWarning": false - }, - "properties": { - "suppressCommitHasNoPreviousCommitWarning": { - "type": "boolean", - "default": false - }, - "suppressCommitNotFoundWarning": { - "type": "boolean", - "default": false - }, - "suppressCreatePullRequestPrompt": { - "type": "boolean", - "default": false - }, - "suppressDebugLoggingWarning": { - "type": "boolean", - "default": false - }, - "suppressFileNotUnderSourceControlWarning": { - "type": "boolean", - "default": false - }, - "suppressGitDisabledWarning": { - "type": "boolean", - "default": false - }, - "suppressGitMissingWarning": { - "type": "boolean", - "default": false }, - "suppressGitVersionWarning": { - "type": "boolean", - "default": false - }, - "suppressImproperWorkspaceCasingWarning": { - "type": "boolean", - "default": false - }, - "suppressLineUncommittedWarning": { - "type": "boolean", - "default": false - }, - "suppressNoRepositoryWarning": { - "type": "boolean", - "default": false + "additionalProperties": false, + "markdownDescription": "Specifies which messages should be suppressed", + "scope": "window", + "order": 0 + }, + "gitlens.advanced.repositorySearchDepth": { + "type": "number", + "default": 1, + "markdownDescription": "Specifies how many folders deep to search for repositories", + "scope": "resource", + "order": 10 + }, + "gitlens.advanced.abbreviatedShaLength": { + "type": "number", + "default": 7, + "markdownDescription": "Specifies the length of abbreviated commit SHAs", + "scope": "window", + "order": 20 + }, + "gitlens.advanced.abbreviateShaOnCopy": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to copy full or abbreviated commit SHAs to the clipboard. Abbreviates to the length of `#gitlens.advanced.abbreviatedShaLength#`.", + "scope": "window", + "order": 21 + }, + "gitlens.advanced.commitOrdering": { + "type": [ + "string", + "null" + ], + "default": null, + "enum": [ + null, + "date", + "author-date", + "topo" + ], + "enumDescriptions": [ + "Shows commits in reverse chronological order", + "Shows commits in reverse chronological order of the commit timestamp", + "Shows commits in reverse chronological order of the author timestamp", + "Shows commits in reverse chronological order of the commit timestamp, but avoids intermixing multiple lines of history" + ], + "markdownDescription": "Specifies the order by which commits will be shown. If unspecified, commits will be shown in reverse chronological order", + "scope": "window", + "order": 30 + }, + "gitlens.blame.ignoreWhitespace": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies whether to ignore whitespace when comparing revisions during blame operations", + "scope": "resource", + "order": 40 + }, + "gitlens.advanced.blame.customArguments": { + "type": [ + "array", + "null" + ], + "default": null, + "items": { + "type": "string" }, - "suppressRebaseSwitchToTextWarning": { - "type": "boolean", - "default": false - } - }, - "additionalProperties": false, - "markdownDescription": "Specifies which messages should be suppressed", - "scope": "window" - }, - "gitlens.advanced.quickPick.closeOnFocusOut": { - "type": "boolean", - "default": true, - "markdownDescription": "Specifies whether to dismiss quick pick menus when focus is lost (if not, press `ESC` to dismiss)", - "scope": "window" - }, - "gitlens.advanced.repositorySearchDepth": { - "type": "number", - "default": 1, - "markdownDescription": "Specifies how many folders deep to search for repositories", - "scope": "resource" - }, - "gitlens.advanced.similarityThreshold": { - "type": [ - "number", - "null" - ], - "default": null, - "markdownDescription": "Specifies the amount (percent) of similarity a deleted and added file pair must have to be considered a rename", - "scope": "window" - }, - "gitlens.advanced.useSymmetricDifferenceNotation": { - "deprecationMessage": "Deprecated. This setting is no longer used", - "markdownDescription": "Deprecated. This setting is no longer used" + "markdownDescription": "Specifies additional arguments to pass to the `git blame` command", + "scope": "resource", + "order": 41 + }, + "gitlens.advanced.blame.delayAfterEdit": { + "type": "number", + "default": 5000, + "markdownDescription": "Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait", + "scope": "window", + "order": 42 + }, + "gitlens.advanced.blame.sizeThresholdAfterEdit": { + "type": "number", + "default": 5000, + "markdownDescription": "Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum", + "scope": "window", + "order": 43 + }, + "gitlens.advanced.similarityThreshold": { + "type": [ + "number", + "null" + ], + "default": null, + "markdownDescription": "Specifies the amount (percent) of similarity a deleted and added file pair must have to be considered a rename", + "scope": "window", + "order": 50 + }, + "gitlens.advanced.externalDiffTool": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies an optional external diff tool to use when comparing files. Must be a configured [Git difftool](https://git-scm.com/docs/git-config#Documentation/git-config.txt-difftool).", + "scope": "window", + "order": 60 + }, + "gitlens.advanced.externalDirectoryDiffTool": { + "type": [ + "string", + "null" + ], + "default": null, + "markdownDescription": "Specifies an optional external diff tool to use when comparing directories. Must be a configured [Git difftool](https://git-scm.com/docs/git-config#Documentation/git-config.txt-difftool).", + "scope": "window", + "order": 61 + }, + "gitlens.advanced.quickPick.closeOnFocusOut": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to dismiss quick pick menus when focus is lost (if not, press `ESC` to dismiss)", + "scope": "window", + "order": 70 + }, + "gitlens.advanced.maxListItems": { + "type": "number", + "default": 200, + "markdownDescription": "Specifies the maximum number of items to show in a list. Use 0 to specify no maximum", + "scope": "window", + "order": 80 + }, + "gitlens.advanced.maxSearchItems": { + "type": "number", + "default": 200, + "markdownDescription": "Specifies the maximum number of items to show in a search. Use 0 to specify no maximum", + "scope": "window", + "order": 81 + }, + "gitlens.advanced.caching.enabled": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether git output will be cached — changing the default is not recommended", + "scope": "window", + "order": 90 + }, + "gitlens.debug": { + "type": "boolean", + "default": false, + "markdownDescription": "Specifies debug mode", + "scope": "window", + "order": 100 + }, + "gitlens.advanced.useSymmetricDifferenceNotation": { + "deprecationMessage": "Deprecated. This setting is no longer used", + "markdownDescription": "Deprecated. This setting is no longer used" + } + } + }, + { + "title": "General", + "order": 0, + "properties": { + "gitlens.showWelcomeOnInstall": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the Welcome (Quick Setup) experience on first install", + "scope": "window", + "order": 10 + }, + "gitlens.showWhatsNewAfterUpgrades": { + "type": "boolean", + "default": true, + "markdownDescription": "Specifies whether to show the What's New notification after upgrading to new feature releases", + "scope": "window", + "order": 20 + }, + "gitlens.outputLevel": { + "type": "string", + "default": "errors", + "enum": [ + "silent", + "errors", + "verbose", + "debug" + ], + "enumDescriptions": [ + "Logs nothing", + "Logs only errors", + "Logs all errors, warnings, and messages", + "Logs all errors, warnings, and messages with extra context useful for debugging" + ], + "markdownDescription": "Specifies how much (if any) output will be sent to the GitLens output channel", + "scope": "window", + "order": 30 + }, + "gitlens.defaultGravatarsStyle": { + "type": "string", + "default": "robohash", + "enum": [ + "identicon", + "mp", + "monsterid", + "retro", + "robohash", + "wavatar" + ], + "enumDescriptions": [ + "A geometric pattern", + "A simple, cartoon-style silhouetted outline of a person (does not vary by email hash)", + "A monster with different colors, faces, etc", + "8-bit arcade-style pixelated faces", + "A robot with different colors, faces, etc", + "A face with differing features and backgrounds" + ], + "markdownDescription": "Specifies the style of the gravatar default (fallback) images", + "scope": "window", + "order": 40 + }, + "gitlens.fileAnnotations.command": { + "type": [ + "string", + "null" + ], + "default": null, + "enum": [ + null, + "blame", + "heatmap", + "changes" + ], + "enumDescriptions": [ + "Shows a menu to choose which file annotations to toggle", + "Toggles gutter blame annotations", + "Toggles gutter heatmap annotations", + "Toggles gutter changes annotations" + ], + "markdownDescription": "Specifies whether the file annotations button in the editor title shows a menu or immediately toggles the specified file annotations", + "scope": "window", + "order": 50 + }, + "gitlens.insiders": { + "deprecationMessage": "Deprecated. Use the Insiders edition of GitLens instead", + "markdownDeprecationMessage": "Deprecated. Use the [Insiders edition](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens-insiders) of GitLens instead" + } } } - }, + ], "configurationDefaults": { "[azure-pipelines]": { "gitlens.codeLens.scopes": [