package.json

{
  "name": "dap",
  "displayName": "KDAB DAP",
  "description": "Debug C/C++ programs using GDB's or LLDB's built-in Debug Adapter Protocol support",
  "version": "1.3.0",
  "publisher": "KDAB",
  "repository": {
    "type": "git",
    "url": "https://github.com/KDAB/vscode-dap.git"
  },
  "bugs": {
    "url": "https://github.com/KDAB/vscode-dap/issues"
  },
  "homepage": "https://github.com/KDAB/vscode-dap#readme",
  "engines": {
    "vscode": "^1.90.0"
  },
  "license": "MIT",
  "categories": [
    "Debuggers"
  ],
  "activationEvents": [
    "onDebugResolve:kdap",
    "onDebugResolve:kdap-lldb"
  ],
  "main": "./out/extension.js",
  "scripts": {
    "vscode:prepublish": "npm run compile",
    "compile": "tsc -p ./",
    "watch": "tsc -watch -p ./",
    "pretest": "tsc -p tsconfig.test.json && npm run lint",
    "lint": "eslint src/ --max-warnings 0",
    "test": "npm run test:unit && npm run test:integration",
    "test:unit": "mocha --ui tdd \"out/test/unit/**/*.test.js\"",
    "test:integration": "vscode-test",
    "format:check": "prettier --check \"src/**/*.ts\"",
    "format:fix": "prettier --write \"src/**/*.ts\""
  },
  "devDependencies": {
    "@eslint/js": "^10.0.1",
    "@types/mocha": "^10.0.10",
    "@types/node": "^22.20.1",
    "@types/vscode": "^1.90.0",
    "@vscode/test-cli": "^0.0.15",
    "@vscode/test-electron": "^3.0.0",
    "eslint": "^10.9.1",
    "mocha": "^11.8.0",
    "prettier": "3.9.6",
    "typescript": "^6.0.3",
    "typescript-eslint": "^8.68.0"
  },
  "keywords": [
    "KDAB",
    "GDB",
    "LLDB",
    "DAP",
    "debugger",
    "C",
    "C++"
  ],
  "icon": "kdab.png",
  "capabilities": {
    "untrustedWorkspaces": {
      "supported": false
    },
    "virtualWorkspaces": false
  },
  "contributes": {
    "configuration": {
      "type": "object",
      "title": "KDAB DAP",
      "properties": {
        "kdap.gdb.path": {
          "scope": "resource",
          "type": "string",
          "description": "The path to the gdb binary. Defaults to searching for 'gdb' in PATH."
        },
        "kdap.lldb.path": {
          "scope": "resource",
          "type": "string",
          "description": "The path to the lldb-dap binary. Defaults to searching for 'lldb-dap', then 'lldb-dap-<version>', in PATH; on macOS, where Xcode keeps lldb-dap out of PATH, it then asks xcrun for it."
        },
        "kdap.logPath": {
          "scope": "resource",
          "type": "string",
          "description": "Enable DAP logging. Logs are written to this filename. If empty, logging is disabled."
        },
        "kdap.gdb.logLevel": {
          "scope": "resource",
          "type": "integer",
          "description": "Set gdb's DAP logging level. The default is 1, which logs the DAP protocol and unexpected exceptions. Level 2 also logs exceptions that are considered expected, such as a failure to parse an expression.",
          "default": 1,
          "minimum": 1,
          "maximum": 2
        },
        "kdap.environment": {
          "scope": "resource",
          "type": "object",
          "default": {},
          "description": "Extra environment variables to set on the debugger process.",
          "additionalProperties": {
            "type": "string"
          }
        }
      }
    },
    "commands": [
      {
        "command": "kdap.downloadQtPrettyPrinters",
        "title": "Download Qt Pretty Printers",
        "category": "KDAB DAP"
      },
      {
        "command": "kdap.runWithArgs",
        "title": "Run with Args",
        "category": "KDAB DAP"
      },
      {
        "command": "kdap.debugWithArgs",
        "title": "Debug with Args",
        "category": "KDAB DAP"
      },
      {
        "command": "kdap.loadCoreFile",
        "title": "Load Core File",
        "category": "KDAB DAP"
      }
    ],
    "menus": {
      "commandPalette": [
        {
          "command": "kdap.downloadQtPrettyPrinters",
          "when": "isLinux"
        },
        {
          "command": "kdap.runWithArgs",
          "when": "isLinux || isMac"
        },
        {
          "command": "kdap.debugWithArgs",
          "when": "isLinux || isMac"
        },
        {
          "command": "kdap.loadCoreFile",
          "when": "isLinux || isMac"
        }
      ]
    },
    "breakpoints": [
      {
        "language": "c"
      },
      {
        "language": "cpp"
      },
      {
        "language": "rust"
      }
    ],
    "debuggers": [
      {
        "type": "kdap",
        "label": "GDB (DAP)",
        "languages": [
          "c",
          "cpp"
        ],
        "configurationAttributes": {
          "launch": {
            "required": [
              "program"
            ],
            "properties": {
              "debuggerPath": {
                "type": "string",
                "markdownDescription": "The path to the gdb executable to use."
              },
              "sysroot": {
                "type": "string",
                "description": "Path to the system root gdb should use when looking for shared libraries and debug info, as if by 'set sysroot'. If empty or omitted, gdb's default sysroot handling applies."
              },
              "skipInitFiles": {
                "type": "boolean",
                "description": "Skip reading the debugger's own init files. For gdb, as if by passing '-nx'.",
                "default": false
              },
              "sourceFileMap": {
                "type": "object",
                "description": "Maps source paths recorded in the debug info to their location on disk, as if by 'set substitute-path'. Each key is the path as recorded in the debug info and each value is where that path is found locally.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "qtPrettyPrinters": {
                "type": "boolean",
                "description": "Automatically load Qt pretty-printers for gdb. If they haven't been downloaded yet, starting a debug session offers to download them.",
                "default": false
              },
              "program": {
                "type": "string",
                "description": "Path to the executable to debug. Corresponds to gdb's 'file' command."
              },
              "args": {
                "type": "array",
                "description": "Command-line arguments passed to the inferior, as if by 'set args'.",
                "default": []
              },
              "cwd": {
                "type": "string",
                "markdownDescription": "The working directory for gdb and the launched program. If omitted, gdb inherits VS Code's working directory rather than the workspace folder, so set this explicitly (e.g. `${workspaceFolder}`)."
              },
              "env": {
                "type": "object",
                "description": "Environment variables for the inferior. Each key is a variable name and each value must be a string. Setting this replaces the inferior's entire environment rather than adding to it, so PATH, HOME and friends must be listed too. If omitted, the inferior inherits gdb's environment."
              },
              "stopAtBeginningOfMainSubprogram": {
                "type": "boolean",
                "description": "Set a temporary breakpoint at the program's main procedure, as if by the 'start' command.",
                "default": false
              },
              "stopOnEntry": {
                "type": "boolean",
                "description": "Set a temporary breakpoint at the program's first instruction, as if by the 'starti' command.",
                "default": false
              }
            }
          },
          "attach": {
            "properties": {
              "debuggerPath": {
                "type": "string",
                "markdownDescription": "The path to the gdb executable to use."
              },
              "sysroot": {
                "type": "string",
                "description": "Path to the system root gdb should use when looking for shared libraries and debug info, as if by 'set sysroot'. If empty or omitted, gdb's default sysroot handling applies."
              },
              "skipInitFiles": {
                "type": "boolean",
                "description": "Skip reading the debugger's own init files. For gdb, as if by passing '-nx'.",
                "default": false
              },
              "sourceFileMap": {
                "type": "object",
                "description": "Maps source paths recorded in the debug info to their location on disk, as if by 'set substitute-path'. Each key is the path as recorded in the debug info and each value is where that path is found locally.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "qtPrettyPrinters": {
                "type": "boolean",
                "description": "Automatically load Qt pretty-printers for gdb. If they haven't been downloaded yet, starting a debug session offers to download them.",
                "default": false
              },
              "pid": {
                "type": [
                  "number",
                  "string"
                ],
                "description": "The process ID to which gdb should attach."
              },
              "program": {
                "type": "string",
                "description": "Path to the executable being debugged. In some cases gdb can determine this automatically, but for many remote targets it must be supplied."
              },
              "target": {
                "type": "string",
                "description": "The target to which gdb should connect, passed to the 'target remote' command."
              },
              "coreFile": {
                "type": "string",
                "description": "Path to a core dump file to load instead of attaching to a live process."
              }
            }
          }
        },
        "initialConfigurations": [
          {
            "type": "kdap",
            "request": "launch",
            "name": "Debug",
            "program": "${workspaceFolder}/<your program>",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopOnEntry": true
          }
        ],
        "configurationSnippets": [
          {
            "label": "GDB: Launch",
            "description": "Launch a program under gdb",
            "body": {
              "type": "kdap",
              "request": "launch",
              "name": "${2:Launch}",
              "program": "^\"\\${workspaceFolder}/${1:<your program>}\"",
              "args": [],
              "cwd": "^\"\\${workspaceFolder}\"",
              "stopOnEntry": true
            }
          },
          {
            "label": "GDB: Attach",
            "description": "Attach gdb to a running process",
            "body": {
              "type": "kdap",
              "request": "attach",
              "name": "${2:Attach}",
              "program": "${1:<your program>}"
            }
          },
          {
            "label": "GDB: Load Core Dump",
            "description": "Load a core dump in gdb",
            "body": {
              "type": "kdap",
              "request": "attach",
              "name": "${2:Core}",
              "program": "${1:<your program>}",
              "coreFile": "${1:<your program>}.core"
            }
          }
        ]
      },
      {
        "type": "kdap-lldb",
        "label": "LLDB (DAP)",
        "languages": [
          "c",
          "cpp"
        ],
        "configurationAttributes": {
          "launch": {
            "required": [
              "program"
            ],
            "properties": {
              "debuggerPath": {
                "type": "string",
                "markdownDescription": "The path to the lldb-dap executable to use."
              },
              "sourceFileMap": {
                "type": "object",
                "description": "Maps source paths recorded in the debug info to their location on disk, as if by 'settings set target.source-map'. Each key is the path as recorded in the debug info and each value is where that path is found locally.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "qtPrettyPrinters": {
                "type": "boolean",
                "description": "Load the Qt pretty-printers bundled with this extension by importing them as an lldb Python module.",
                "default": false
              },
              "program": {
                "type": "string",
                "description": "Path to the executable to debug."
              },
              "args": {
                "type": "array",
                "description": "Command-line arguments passed to the inferior.",
                "default": []
              },
              "cwd": {
                "type": "string",
                "markdownDescription": "The working directory for lldb-dap and the launched program. If omitted, lldb-dap inherits VS Code's working directory rather than the workspace folder, so set this explicitly (e.g. `${workspaceFolder}`)."
              },
              "env": {
                "type": "object",
                "description": "Environment variables for the inferior. Each key is a variable name and each value must be a string. These are added to the environment the inferior inherits rather than replacing it.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "stopOnEntry": {
                "type": "boolean",
                "description": "Stop at the program's entry point.",
                "default": false
              },
              "initCommands": {
                "type": "array",
                "description": "lldb commands run once the debugger has been created, before the target exists. The place for 'platform select', pretty printer scripts, and anything else that must precede the target.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "preRunCommands": {
                "type": "array",
                "description": "lldb commands run after the target is created but before the program is launched or attached to.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "postRunCommands": {
                "type": "array",
                "description": "lldb commands run once the program has been launched or attached to.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "stopCommands": {
                "type": "array",
                "description": "lldb commands run each time the program stops.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "exitCommands": {
                "type": "array",
                "description": "lldb commands run once the program has exited.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "terminateCommands": {
                "type": "array",
                "description": "lldb commands run when the debug session ends.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "platformName": {
                "type": "string",
                "description": "The lldb platform to select, as if by 'platform select'. Needed for remote targets."
              },
              "targetTriple": {
                "type": "string",
                "description": "The target triple to debug for, overriding the one recorded in the executable."
              },
              "debuggerRoot": {
                "type": "string",
                "description": "Directory lldb-dap chdirs to before doing anything else, so that relative paths in commands resolve predictably."
              },
              "enableAutoVariableSummaries": {
                "type": "boolean",
                "description": "Show auto-generated summaries for variables when no language-specific summary applies.",
                "default": false
              },
              "enableSyntheticChildDebugging": {
                "type": "boolean",
                "description": "Alongside a synthetic child, also show the raw value it was synthesised from.",
                "default": false
              },
              "displayExtendedBacktrace": {
                "type": "boolean",
                "description": "Include extended backtraces, where the platform provides them.",
                "default": false
              },
              "customFrameFormat": {
                "type": "string",
                "description": "Format string for stack frame names, using lldb's frame-format syntax."
              },
              "customThreadFormat": {
                "type": "string",
                "description": "Format string for thread names, using lldb's thread-format syntax."
              },
              "timeout": {
                "type": "number",
                "description": "Seconds to wait for launchCommands or attachCommands to establish a valid target."
              },
              "launchCommands": {
                "type": "array",
                "description": "lldb commands used to launch the program instead of lldb-dap doing it. The last of them must leave a valid, launched target.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "runInTerminal": {
                "type": "boolean",
                "description": "Launch the program in an integrated terminal, so that it can read from stdin.",
                "default": false
              },
              "disableASLR": {
                "type": "boolean",
                "description": "Disable address space layout randomisation for the program.",
                "default": true
              },
              "disableSTDIO": {
                "type": "boolean",
                "description": "Launch the program without stdin, stdout or stderr.",
                "default": false
              },
              "shellExpandArguments": {
                "type": "boolean",
                "description": "Let a shell expand the program's arguments before launching it.",
                "default": false
              },
              "detachOnError": {
                "type": "boolean",
                "description": "Detach from the program if an error is encountered while launching it.",
                "default": false
              }
            }
          },
          "attach": {
            "properties": {
              "debuggerPath": {
                "type": "string",
                "markdownDescription": "The path to the lldb-dap executable to use."
              },
              "sourceFileMap": {
                "type": "object",
                "description": "Maps source paths recorded in the debug info to their location on disk, as if by 'settings set target.source-map'. Each key is the path as recorded in the debug info and each value is where that path is found locally.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "qtPrettyPrinters": {
                "type": "boolean",
                "description": "Load the Qt pretty-printers bundled with this extension by importing them as an lldb Python module.",
                "default": false
              },
              "pid": {
                "type": [
                  "number",
                  "string"
                ],
                "description": "The process ID to which lldb should attach."
              },
              "program": {
                "type": "string",
                "description": "Path to the executable being debugged."
              },
              "coreFile": {
                "type": "string",
                "description": "Path to a core dump file to load instead of attaching to a live process."
              },
              "initCommands": {
                "type": "array",
                "description": "lldb commands run once the debugger has been created, before the target exists. The place for 'platform select', pretty printer scripts, and anything else that must precede the target.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "preRunCommands": {
                "type": "array",
                "description": "lldb commands run after the target is created but before the program is launched or attached to.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "postRunCommands": {
                "type": "array",
                "description": "lldb commands run once the program has been launched or attached to.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "stopCommands": {
                "type": "array",
                "description": "lldb commands run each time the program stops.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "exitCommands": {
                "type": "array",
                "description": "lldb commands run once the program has exited.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "terminateCommands": {
                "type": "array",
                "description": "lldb commands run when the debug session ends.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "platformName": {
                "type": "string",
                "description": "The lldb platform to select, as if by 'platform select'. Needed for remote targets."
              },
              "targetTriple": {
                "type": "string",
                "description": "The target triple to debug for, overriding the one recorded in the executable."
              },
              "debuggerRoot": {
                "type": "string",
                "description": "Directory lldb-dap chdirs to before doing anything else, so that relative paths in commands resolve predictably."
              },
              "enableAutoVariableSummaries": {
                "type": "boolean",
                "description": "Show auto-generated summaries for variables when no language-specific summary applies.",
                "default": false
              },
              "enableSyntheticChildDebugging": {
                "type": "boolean",
                "description": "Alongside a synthetic child, also show the raw value it was synthesised from.",
                "default": false
              },
              "displayExtendedBacktrace": {
                "type": "boolean",
                "description": "Include extended backtraces, where the platform provides them.",
                "default": false
              },
              "customFrameFormat": {
                "type": "string",
                "description": "Format string for stack frame names, using lldb's frame-format syntax."
              },
              "customThreadFormat": {
                "type": "string",
                "description": "Format string for thread names, using lldb's thread-format syntax."
              },
              "timeout": {
                "type": "number",
                "description": "Seconds to wait for launchCommands or attachCommands to establish a valid target."
              },
              "attachCommands": {
                "type": "array",
                "description": "lldb commands used to attach instead of lldb-dap doing it. The last of them must leave a valid, attached target.",
                "items": {
                  "type": "string"
                },
                "default": []
              },
              "waitFor": {
                "type": "boolean",
                "description": "Wait for the next instance of the program to be launched and attach to that, rather than requiring a pid.",
                "default": false
              }
            }
          }
        },
        "initialConfigurations": [
          {
            "type": "kdap-lldb",
            "request": "launch",
            "name": "Debug (LLDB)",
            "program": "${workspaceFolder}/<your program>",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopOnEntry": true
          }
        ],
        "configurationSnippets": [
          {
            "label": "LLDB: Launch",
            "description": "Launch a program under lldb-dap",
            "body": {
              "type": "kdap-lldb",
              "request": "launch",
              "name": "${2:Launch}",
              "program": "^\"\\${workspaceFolder}/${1:<your program>}\"",
              "args": [],
              "cwd": "^\"\\${workspaceFolder}\"",
              "stopOnEntry": true
            }
          },
          {
            "label": "LLDB: Attach",
            "description": "Attach lldb-dap to a running process",
            "body": {
              "type": "kdap-lldb",
              "request": "attach",
              "name": "${2:Attach}",
              "program": "${1:<your program>}"
            }
          },
          {
            "label": "LLDB: Load Core Dump",
            "description": "Load a core dump in lldb-dap",
            "body": {
              "type": "kdap-lldb",
              "request": "attach",
              "name": "${2:Core}",
              "program": "${1:<your program>}",
              "coreFile": "${1:<your program>}.core"
            }
          }
        ]
      }
    ]
  }
}