settings.json

{
  "version": 1,
  "groups": [
    {
      "id": "project",
      "order": 10,
      "title": "Project"
    },
    {
      "id": "tasks",
      "order": 20,
      "title": "Tasks"
    },
    {
      "id": "languageService",
      "order": 30,
      "title": "C++ Modules language service"
    },
    {
      "id": "toml",
      "order": 40,
      "title": "mcpp.toml editing"
    },
    {
      "id": "buildScript",
      "order": 50,
      "title": "build.mcpp editing"
    },
    {
      "id": "cache",
      "order": 60,
      "title": "Cache"
    },
    {
      "id": "views",
      "order": 70,
      "title": "Views"
    },
    {
      "id": "ui",
      "order": 80,
      "title": "Interface"
    },
    {
      "id": "diagnostics",
      "order": 90,
      "title": "Diagnostics and logging"
    },
    {
      "id": "advanced",
      "order": 100,
      "title": "Advanced"
    }
  ],
  "settings": [
    {
      "key": "mcpp.path",
      "type": "string",
      "default": "",
      "scope": "resource",
      "group": "project",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.1.0",
      "title": "Set the mcpp executable path",
      "description": "Path to the mcpp CLI used for every mcpp command. Leave it empty to look up mcpp on the PATH of the VS Code process."
    },
    {
      "key": "mcpp.project.discoveryBoundary",
      "type": "string",
      "default": "workspaceFolder",
      "enum": [
        "workspaceFolder",
        "filesystem"
      ],
      "scope": "resource",
      "group": "project",
      "order": 20,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Limit project discovery scope",
      "description": "How far the extension walks to find mcpp.toml. \"filesystem\" also searches outside the workspace folder; it costs more I/O and can reach unrelated trees."
    },
    {
      "key": "mcpp.task.clearTerminal",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "tasks",
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Clear the task terminal",
      "description": "Clear the terminal before an mcpp task starts, so the last build's output is not mistaken for this one's.",
      "order": 1
    },
    {
      "key": "mcpp.task.buildArgs",
      "type": "array",
      "default": [],
      "scope": "resource",
      "group": "tasks",
      "order": 10,
      "tier": "public",
      "applies": "next-build",
      "since": "0.5.0",
      "title": "Add arguments to mcpp build",
      "description": "Extra arguments appended to the mcpp build task. Applied on the next build.",
      "items": {
        "type": "string"
      }
    },
    {
      "key": "mcpp.task.runArgs",
      "type": "array",
      "default": [],
      "scope": "resource",
      "group": "tasks",
      "order": 20,
      "tier": "public",
      "applies": "next-build",
      "since": "0.5.0",
      "title": "Add arguments to mcpp run",
      "description": "Extra arguments appended to the mcpp run task. Applied on the next run.",
      "items": {
        "type": "string"
      }
    },
    {
      "key": "mcpp.task.testArgs",
      "type": "array",
      "default": [],
      "scope": "resource",
      "group": "tasks",
      "order": 30,
      "tier": "public",
      "applies": "next-build",
      "since": "0.5.0",
      "title": "Add arguments to mcpp test",
      "description": "Extra arguments appended to the mcpp test task. Applied on the next test run.",
      "items": {
        "type": "string"
      }
    },
    {
      "key": "mcpp.task.cleanArgs",
      "type": "array",
      "default": [],
      "scope": "resource",
      "group": "tasks",
      "order": 40,
      "tier": "public",
      "applies": "next-clean",
      "since": "0.5.0",
      "title": "Add arguments to mcpp clean",
      "description": "Extra arguments appended to the mcpp clean task. Applied on the next clean.",
      "items": {
        "type": "string"
      }
    },
    {
      "key": "mcpp.task.confirmClean",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "tasks",
      "order": 50,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Confirm before cleaning",
      "description": "Ask for confirmation before a clean task deletes the target directory of the project."
    },
    {
      "key": "mcpp.task.revealTerminal",
      "type": "string",
      "default": "always",
      "enum": [
        "always",
        "onFailure",
        "never"
      ],
      "scope": "resource",
      "group": "tasks",
      "order": 60,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Reveal the task terminal",
      "description": "When an mcpp task brings the terminal panel to the front: always, only when the task fails, or never."
    },
    {
      "key": "mcpp.task.focusTerminal",
      "type": "boolean",
      "default": false,
      "scope": "resource",
      "group": "tasks",
      "order": 70,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Focus the task terminal",
      "description": "Move keyboard focus to the terminal while an mcpp task runs. Off by default so editor focus is not taken away."
    },
    {
      "key": "mcpp.task.problemMatcher",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "tasks",
      "order": 80,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Parse task problems",
      "description": "Parse compiler output of the mcpp build and test tasks into the Problems panel."
    },
    {
      "key": "mcpp.task.editorTitleButtons",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "tasks",
      "order": 90,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show editor title buttons",
      "description": "Show the Run and Test buttons in the editor title bar while the file belongs to an mcpp project."
    },
    {
      "key": "mcpp.build.onSave",
      "type": "boolean",
      "default": false,
      "scope": "resource",
      "group": "tasks",
      "order": 100,
      "tier": "public",
      "applies": "immediate",
      "since": "1.0.0",
      "title": "Build when a file is saved",
      "description": "Start a build of the file's project when a source or mcpp.toml is saved. A save while a build waits replaces it; a running build is cancelled and started again."
    },
    {
      "key": "mcpp.build.profile",
      "type": "string",
      "default": "dev",
      "enum": [
        "dev",
        "release"
      ],
      "scope": "resource",
      "group": "tasks",
      "order": 110,
      "tier": "public",
      "applies": "immediate",
      "since": "1.0.0",
      "title": "Choose the build profile",
      "description": "The profile build, run, test and debug use: dev (unoptimised, debug information) or release."
    },
    {
      "key": "mcpp.build.target",
      "type": "string",
      "default": "",
      "scope": "resource",
      "group": "tasks",
      "order": 120,
      "tier": "public",
      "applies": "immediate",
      "since": "1.0.0",
      "title": "Choose the build target",
      "description": "The target build, run, test, debug and pack use, as mcpp names it (x86_64-linux-musl, x86_64-openkal). Empty: this machine. The Targets panel lists the targets and the platform that configures each."
    },
    {
      "key": "mcpp.debug.engine",
      "type": "string",
      "default": "auto",
      "enum": [
        "auto",
        "cppdbg",
        "lldb",
        "lldb-dap",
        "gdb"
      ],
      "scope": "resource",
      "group": "tasks",
      "order": 130,
      "tier": "public",
      "applies": "immediate",
      "since": "1.0.0",
      "title": "Choose the debugger",
      "description": "The debug adapter a debug session uses. auto: CodeLLDB when it is installed, then the C/C++ extension's gdb or lldb, then lldb-dap."
    },
    {
      "key": "mcpp.codeLens.enable",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "tasks",
      "order": 140,
      "tier": "public",
      "applies": "immediate",
      "since": "1.1.0",
      "title": "Show Run and Debug above main",
      "description": "A CodeLens above the main of a program or a test: Run and Debug. Where C++ Modules serves the file its position is the language service's; otherwise the line is read from the text."
    },
    {
      "key": "mcpp.test.macros",
      "type": "array",
      "default": [],
      "scope": "resource",
      "group": "tasks",
      "order": 150,
      "tier": "advanced",
      "applies": "immediate",
      "since": "1.1.0",
      "title": "Add a test framework's macros",
      "description": "Macros that write a test framework's cases, each as framework:MACRO (gtest:MY_TEST). A test program's cases are listed only when its source calls one of its framework's macros."
    },
    {
      "key": "mcpp.languageService.menuItems",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "languageService",
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show language-service entries in the menu",
      "description": "Keep the C++ Modules actions in the mcpp quick menu. Turn off to leave the menu to mcpp's own commands.",
      "order": 1
    },
    {
      "key": "mcpp.languageService.confirmResetCache",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "languageService",
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Confirm resetting the workspace cache",
      "description": "Ask before running the C++ Modules reset, which discards this workspace's model cache and prepares it again. Turning this off removes the only warning before that happens.",
      "order": 2
    },
    {
      "key": "mcpp.languageService.refreshAfterBuild",
      "type": "string",
      "default": "auto",
      "enum": [
        "auto",
        "reload",
        "restart",
        "off"
      ],
      "scope": "resource",
      "group": "languageService",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Refresh language service after build",
      "description": "How mcpp-vscode tells the C++ Modules extension about a finished build: auto, a lightweight reload, a full restart, or nothing."
    },
    {
      "key": "mcpp.languageService.notifyOnDegraded",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "languageService",
      "order": 20,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Notify when the language service degrades",
      "description": "Show a notification when the C++ Modules language service reports a degraded state."
    },
    {
      "key": "mcpp.languageService.readState",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "languageService",
      "order": 30,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Read language service state",
      "description": "Read status from the C++ Modules extension through the API it exposes for tests. Turning this off only hides status; it never changes mcppls itself."
    },
    {
      "key": "mcpp.languageService.stateRefreshSeconds",
      "type": "number",
      "default": 0,
      "minimum": 0,
      "scope": "resource",
      "group": "languageService",
      "order": 40,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the state refresh interval",
      "description": "Re-read the language service state every this many seconds. 0 disables the timer."
    },
    {
      "key": "mcpp.toml.completion",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "toml",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "aliases": [
        "mcpp.tomlCompletion"
      ],
      "title": "Complete mcpp.toml keys",
      "description": "Offer section, key and value completion while editing mcpp.toml. The old mcpp.tomlCompletion key still works as an alias."
    },
    {
      "key": "mcpp.toml.hover",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "toml",
      "order": 20,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show mcpp.toml hovers",
      "description": "Show documentation for sections and keys when hovering in mcpp.toml."
    },
    {
      "key": "mcpp.toml.navigation",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "toml",
      "order": 30,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Navigate inside mcpp.toml",
      "description": "Enable go-to-definition for workspace, path and feature references in mcpp.toml."
    },
    {
      "key": "mcpp.toml.diagnostics.enabled",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "toml",
      "order": 40,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Enable mcpp.toml diagnostics",
      "description": "Turn all mcpp.toml validation on or off. Every rule keeps its own severity setting."
    },
    {
      "key": "mcpp.toml.diagnostics.syntax",
      "type": "string",
      "default": "error",
      "enum": [
        "error",
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "toml",
      "order": 50,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set syntax diagnostic severity",
      "description": "Severity used for mcpp.toml syntax errors.",
      "deprecationMessage": "mcpp reports mcpp.toml problems itself, with their location; this setting no longer has an effect."
    },
    {
      "key": "mcpp.toml.diagnostics.unknownSection",
      "type": "string",
      "default": "warning",
      "enum": [
        "error",
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "toml",
      "order": 60,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set unknown section severity",
      "description": "Severity used for sections that mcpp does not recognise.",
      "deprecationMessage": "mcpp reports mcpp.toml problems itself, with their location; this setting no longer has an effect."
    },
    {
      "key": "mcpp.toml.diagnostics.unknownKey",
      "type": "string",
      "default": "warning",
      "enum": [
        "error",
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "toml",
      "order": 70,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set unknown key severity",
      "description": "Severity used for keys that mcpp does not recognise.",
      "deprecationMessage": "mcpp reports mcpp.toml problems itself, with their location; this setting no longer has an effect."
    },
    {
      "key": "mcpp.toml.diagnostics.planeSeparation",
      "type": "string",
      "default": "warning",
      "enum": [
        "error",
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "toml",
      "order": 80,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set plane separation severity",
      "description": "Severity used when a key is written in the wrong mcpp.toml plane, such as a build key in the library plane.",
      "deprecationMessage": "mcpp reports mcpp.toml problems itself, with their location; this setting no longer has an effect."
    },
    {
      "key": "mcpp.toml.diagnostics.legacyKeys",
      "type": "string",
      "default": "info",
      "enum": [
        "error",
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "toml",
      "order": 90,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set legacy key severity",
      "description": "Severity used for pre-0.5 mcpp.toml keys that still work but should be migrated.",
      "deprecationMessage": "mcpp reports mcpp.toml problems itself, with their location; this setting no longer has an effect."
    },
    {
      "key": "mcpp.toml.indexCompletion",
      "type": "boolean",
      "default": false,
      "scope": "resource",
      "group": "toml",
      "order": 100,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Complete dependency versions",
      "description": "Query the package index to complete dependency versions. Off by default because it needs network access."
    },
    {
      "key": "mcpp.toml.indexCompletionTimeoutSeconds",
      "type": "number",
      "default": 20,
      "minimum": 1,
      "maximum": 600,
      "scope": "resource",
      "group": "toml",
      "order": 110,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the index query timeout",
      "description": "How long one package index query may run before it is abandoned and completion falls back to local data, in seconds."
    },
    {
      "key": "mcpp.buildScript.intelligence",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "buildScript",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Enable build.mcpp intelligence",
      "description": "Turn completion and hover support for build.mcpp on or off."
    },
    {
      "key": "mcpp.buildScript.diagnostics",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "buildScript",
      "order": 20,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Enable build.mcpp diagnostics",
      "description": "Validate build.mcpp against the build API mcpp actually ships."
    },
    {
      "key": "mcpp.buildScript.diagnostics.severity",
      "type": "string",
      "default": "warning",
      "enum": [
        "warning",
        "info",
        "off"
      ],
      "scope": "resource",
      "group": "buildScript",
      "order": 30,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set build.mcpp diagnostic severity",
      "description": "Severity used for build.mcpp diagnostics."
    },
    {
      "key": "mcpp.buildScript.imports.knownModules",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "buildScript",
      "order": 40,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Check imported modules",
      "description": "Offer mcpp's own modules (std, std.compat, mcpp.*) in import completion. Hover still recognises them, and no import is ever reported missing, whichever way this is set."
    },
    {
      "key": "mcpp.buildScript.snippets",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "buildScript",
      "order": 50,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Offer build.mcpp snippets",
      "description": "Offer snippet completions for the mcpp build script API."
    },
    {
      "key": "mcpp.cache.statusBar",
      "type": "boolean",
      "default": false,
      "scope": "resource",
      "group": "cache",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show cache size in status bar",
      "description": "Show the size of the mcpp global cache in the status bar. Off by default to keep the status bar quiet."
    },
    {
      "key": "mcpp.cache.warnAboveGiB",
      "type": "number",
      "default": 0,
      "minimum": 0,
      "scope": "resource",
      "group": "cache",
      "order": 20,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Warn above a cache size",
      "description": "Warn when the mcpp global cache grows past this many GiB. 0 disables the warning."
    },
    {
      "key": "mcpp.cache.staleDays",
      "type": "number",
      "default": 3,
      "minimum": 0,
      "maximum": 365,
      "scope": "resource",
      "group": "cache",
      "order": 30,
      "tier": "public",
      "applies": "next-clean",
      "since": "0.5.0",
      "title": "Mark stale cache entries",
      "description": "Treat cache entries that were not accessed for this many days as stale. 0 disables the age rule."
    },
    {
      "key": "mcpp.cache.autoRefreshSeconds",
      "type": "number",
      "default": 0,
      "minimum": 0,
      "maximum": 3600,
      "scope": "resource",
      "group": "cache",
      "order": 40,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Refresh the cache view automatically",
      "description": "Re-read the cache statistics every this many seconds. 0 disables automatic refreshing."
    },
    {
      "key": "mcpp.cache.estimateProjectBytes",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "cache",
      "order": 50,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Estimate project artifact size",
      "description": "Measure the target directory of the current project so the cache view can show its size."
    },
    {
      "key": "mcpp.cache.showLegacy",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "cache",
      "order": 60,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show legacy cache entries",
      "description": "Include cache entries written by older mcpp versions in the cache view and in cleaning."
    },
    {
      "key": "mcpp.cache.gc.defaultBudgetGiB",
      "type": "number",
      "default": 0,
      "minimum": 0,
      "scope": "resource",
      "group": "cache",
      "order": 70,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the default cleanup budget",
      "description": "Default size budget for cache cleanup, in GiB. 0 asks for a budget on every run."
    },
    {
      "key": "mcpp.cache.gc.confirmAboveGiB",
      "type": "number",
      "default": 1,
      "minimum": 0,
      "scope": "resource",
      "group": "cache",
      "order": 80,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Confirm large cache cleanup",
      "description": "Require an extra confirmation when a cleanup would free more than this many GiB. 0 confirms every cleanup."
    },
    {
      "key": "mcpp.cache.pruneAgeDays",
      "type": "number",
      "default": 30,
      "minimum": 1,
      "scope": "resource",
      "group": "cache",
      "order": 90,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the pruning age",
      "description": "Default age in days used when pruning cache entries older than a threshold."
    },
    {
      "key": "mcpp.views.project.show",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "group": "views",
      "order": 10,
      "tier": "public",
      "applies": "view-reload",
      "since": "0.5.0",
      "title": "Show the project view",
      "description": "Show the mcpp project view in the activity bar. Takes effect after the view container reloads."
    },
    {
      "key": "mcpp.views.cache.show",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "group": "views",
      "order": 20,
      "tier": "public",
      "applies": "view-reload",
      "since": "0.5.0",
      "title": "Show the cache view",
      "description": "Show the mcpp cache view in the activity bar. Takes effect after the view container reloads."
    },
    {
      "key": "mcpp.views.enabled",
      "group": "views",
      "tier": "public",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "applies": "immediate",
      "since": "0.6.0",
      "title": "Hide the mcpp view contents",
      "description": "Turns every mcpp view off at once. The view contents disappear, so the container shows nothing; whether VS Code also removes the mcpp icon from the activity bar is up to VS Code itself, because an extension cannot mark its container as hidden-when-empty. Right-click the icon to hide it there.",
      "order": 30
    },
    {
      "key": "mcpp.views.library.show",
      "group": "views",
      "tier": "public",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "applies": "view-reload",
      "since": "0.6.0",
      "title": "Show the mcpp library ecosystem view",
      "description": "Show the view that browses the package index mcpp has already refreshed locally.",
      "order": 40
    },
    {
      "key": "mcpp.library.indexPath",
      "group": "views",
      "tier": "advanced",
      "type": "string",
      "default": "",
      "scope": "window",
      "applies": "immediate",
      "since": "0.6.0",
      "title": "Path to a mcpp package index checkout",
      "description": "Leave empty to browse the official mcpp-index at <mcpp home>/indices/mcpplibs (legacy registry/data/mcpplibs is supported). MCPP_HOME takes precedence; otherwise the extension asks mcpp self env. Set a directory containing pkgs/ or a collection of indexes to browse a custom source.",
      "order": 50
    },
    {
      "key": "mcpp.library.networkSearch",
      "group": "views",
      "tier": "public",
      "type": "boolean",
      "default": false,
      "scope": "window",
      "applies": "immediate",
      "since": "0.6.0",
      "title": "Search every configured registry over the network",
      "description": "Off by default. Also searches other registries with mcpp search; remote results have limited previews and cannot be added directly.",
      "order": 60
    },
    {
      "key": "mcpp.views.languageServer.show",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "group": "views",
      "order": 70,
      "tier": "public",
      "applies": "view-reload",
      "since": "0.5.0",
      "title": "Show the language-service block in the project view",
      "description": "The C++ Modules state is folded into the project view's basic information. The collapsed row always shows a status icon, so a problem is visible without expanding it."
    },
    {
      "key": "mcpp.views.cache.topN",
      "type": "number",
      "default": 5,
      "minimum": 1,
      "maximum": 50,
      "scope": "window",
      "group": "views",
      "order": 80,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set cache list length",
      "description": "How many entries the cache view lists per group."
    },
    {
      "key": "mcpp.views.cache.ageBuckets",
      "type": "array",
      "default": [
        "1d",
        "7d",
        "30d"
      ],
      "scope": "window",
      "group": "views",
      "order": 90,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set cache age buckets",
      "description": "Age buckets used to group cache entries in the cache view, written as \"1d\", \"7d\" and so on."
    },
    {
      "key": "mcpp.ui.confirmDestructiveOnly",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "group": "ui",
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Confirm only destructive actions",
      "description": "Use a modal dialogue only for actions that cannot be undone. Turning this off asks for confirmation more often, never less.",
      "order": 1
    },
    {
      "key": "mcpp.ui.language",
      "type": "string",
      "default": "auto",
      "enum": [
        "auto",
        "en",
        "zh-cn"
      ],
      "scope": "window",
      "group": "ui",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the extension language",
      "description": "Language for extension messages and panels. \"auto\" follows VS Code; command titles and settings labels always follow the VS Code display language."
    },
    {
      "key": "mcpp.ui.statusBar.show",
      "type": "boolean",
      "default": true,
      "scope": "window",
      "group": "ui",
      "order": 20,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show the mcpp status bar item",
      "description": "Show the main mcpp status bar item."
    },
    {
      "key": "mcpp.ui.statusBar.showLanguageServer",
      "type": "boolean",
      "default": false,
      "scope": "window",
      "group": "ui",
      "order": 30,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Show language service status",
      "description": "Show the C++ Modules language service state in the mcpp status bar item. Off by default because mcppls already has its own status item."
    },
    {
      "key": "mcpp.ui.statusBar.background",
      "type": "string",
      "default": "none",
      "enum": [
        "none",
        "warning",
        "error"
      ],
      "scope": "window",
      "group": "ui",
      "order": 40,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.6.0",
      "title": "Highlight the mcpp status bar item",
      "description": "VS Code accepts only two background colours for a status bar entry, \"statusBarItem.warningBackground\" and \"statusBarItem.errorBackground\", and it overrides the foreground so the text stays readable; any other colour is dropped. The mcpp item is plain by default; \"warning\" gives it the theme's amber chip and \"error\" its red one."
    },
    {
      "key": "mcpp.ui.notifications.success",
      "type": "string",
      "default": "statusBar",
      "enum": [
        "silent",
        "statusBar",
        "toast"
      ],
      "scope": "window",
      "group": "ui",
      "order": 50,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Report successful operations",
      "description": "How successful mcpp operations are reported: in the status bar only, as a toast, or not at all."
    },
    {
      "key": "mcpp.ui.notifications.dedupeMinutes",
      "type": "number",
      "default": 5,
      "minimum": 0,
      "maximum": 1440,
      "scope": "window",
      "group": "ui",
      "order": 60,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Deduplicate notifications",
      "description": "Suppress a repeated notification for this many minutes. 0 shows every notification."
    },
    {
      "key": "mcpp.ui.numberFormat",
      "type": "string",
      "default": "binary",
      "enum": [
        "binary",
        "decimal"
      ],
      "scope": "window",
      "group": "ui",
      "order": 70,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Choose number formatting",
      "description": "Format byte sizes with binary units (KiB, MiB) or decimal units (KB, MB)."
    },
    {
      "key": "mcpp.log.level",
      "type": "string",
      "default": "info",
      "enum": [
        "error",
        "warn",
        "info",
        "debug"
      ],
      "scope": "window",
      "group": "diagnostics",
      "order": 10,
      "tier": "public",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the log level",
      "description": "Amount of detail written to the mcpp output channel. Debug output is verbose."
    },
    {
      "key": "mcpp.diagnostics.selfCheckOnStartup",
      "type": "boolean",
      "default": false,
      "scope": "window",
      "group": "diagnostics",
      "order": 20,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Run a self check at startup",
      "description": "Run the environment self check on activation and write problems to the output channel. Off by default because it starts mcpp."
    },
    {
      "key": "mcpp.runtime.timeoutSeconds",
      "type": "number",
      "default": 30,
      "minimum": 0,
      "maximum": 3600,
      "scope": "resource",
      "group": "advanced",
      "order": 10,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Set the command timeout",
      "description": "How long one mcpp CLI command may run before it is terminated, in seconds. 0 disables the timeout."
    },
    {
      "key": "mcpp.runtime.maxOutputMiB",
      "type": "number",
      "default": 16,
      "minimum": 1,
      "maximum": 1024,
      "scope": "resource",
      "group": "advanced",
      "order": 20,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Cap captured command output",
      "description": "Maximum output captured for one mcpp command, in MiB. When output is truncated the tail is kept."
    },
    {
      "key": "mcpp.runtime.concurrency",
      "type": "string",
      "default": "perProject",
      "enum": [
        "perProject",
        "global"
      ],
      "scope": "resource",
      "group": "advanced",
      "order": 30,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.5.0",
      "title": "Limit concurrent mcpp commands",
      "description": "Whether the one-command-at-a-time rule applies to each project separately or to the whole window."
    },
    {
      "key": "mcpp.clangd.path",
      "type": "string",
      "default": "",
      "scope": "resource",
      "group": "advanced",
      "order": 40,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.4.0",
      "deprecated": true,
      "deprecationMessage": "The C++ module language service moved to sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting.",
      "title": "Deprecated clangd path",
      "description": "Deprecated: The C++ module language service moved to sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting."
    },
    {
      "key": "mcpp.modulesSupport",
      "type": "string",
      "default": "auto",
      "enum": [
        "auto",
        "on",
        "off"
      ],
      "scope": "resource",
      "group": "advanced",
      "order": 50,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.4.0",
      "deprecated": true,
      "deprecationMessage": "The C++ module language service moved to sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting.",
      "title": "Deprecated module support mode",
      "description": "Deprecated: The C++ module language service moved to sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting."
    },
    {
      "key": "mcpp.configureCppTools",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "advanced",
      "order": 60,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.4.0",
      "deprecated": true,
      "deprecationMessage": "Language service conflicts are managed by sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting.",
      "title": "Deprecated C++ tool configuration",
      "description": "Deprecated: Language service conflicts are managed by sunrisepeak.mcpp-language-server; mcpp-vscode no longer reads this setting."
    },
    {
      "key": "mcpp.tomlCompletion",
      "type": "boolean",
      "default": true,
      "scope": "resource",
      "group": "advanced",
      "order": 70,
      "tier": "advanced",
      "applies": "immediate",
      "since": "0.2.6",
      "deprecated": true,
      "deprecationMessage": "mcpp-vscode no longer reads this setting; use mcpp.toml.completion instead.",
      "title": "Deprecated mcpp.toml completion",
      "description": "Deprecated: mcpp-vscode no longer reads this setting; use mcpp.toml.completion instead."
    },
    {
      "key": "mcpp.ide.backendPath",
      "type": "string",
      "default": "",
      "scope": "machine",
      "group": "advanced",
      "order": 80,
      "tier": "advanced",
      "applies": "restart",
      "since": "1.0.0",
      "title": "Set the mcpp-ide backend path",
      "description": "The mcpp-ide program the extension starts. Empty: the backend shipped with the extension, then the one xlings installed, then PATH."
    },
    {
      "key": "mcpp.trust.denyEffects",
      "type": "array",
      "default": [
        "exec-build-script",
        "network"
      ],
      "scope": "window",
      "group": "advanced",
      "order": 90,
      "tier": "advanced",
      "applies": "immediate",
      "since": "1.0.0",
      "title": "Effects denied in an untrusted workspace",
      "description": "What mcpp may not do while the workspace is not trusted (mcpp --deny): a run that needs one of them stops before it and says so. Trusting the workspace lifts the list."
    },
    {
      "key": "mcpp.backend.logLevel",
      "type": "string",
      "default": "info",
      "enum": [
        "error",
        "warning",
        "info",
        "debug"
      ],
      "scope": "window",
      "group": "advanced",
      "order": 100,
      "tier": "advanced",
      "applies": "immediate",
      "since": "1.1.0",
      "title": "Set the backend's log level",
      "description": "What the mcpp-ide backend writes to the editor's log: errors only, warnings, what it does (the default), or every run of mcpp and mcppls with its arguments."
    }
  ]
}