id       = "vscode-oss"
name     = "Code - OSS"
homepage = "https://github.com/microsoft/vscode"
# The icon the source build ships for Linux — Code - OSS's own blue mark,
# not the Visual Studio Code one — from resources/linux in the repository.
icon     = "https://raw.githubusercontent.com/microsoft/vscode/main/resources/linux/code.png"
# product.json at the root of microsoft/vscode is the file that names every one
# of these strings for a source build: "nameShort": "Code - OSS", "nameLong":
# "Code - OSS", "applicationName": "code-oss", "dataFolderName":
# ".vscode-oss". `code-oss` is the command the Linux distributions that package
# this build install, and the name the user types.
executables   = ["code-oss"]

[dotfiles]

# VS Code puts the user directory at <appData>/<nameLong>/User — the trio
# %APPDATA%\<name>, $HOME/Library/Application Support/<name> and
# $HOME/.config/<name> that https://code.visualstudio.com/docs/configure/settings
# gives for the Microsoft build under "Code". A source build differs only in
# the name, which product.json sets to "Code - OSS"; VSCodium's docs/migration.md
# states the same thing from the other side, calling ~/.vscode-oss the extension
# directory of "a freshly cloned copy of vscode built from source".
#
# The trio is [appData], which is what Electron's app.getPath("appData")
# returns and where VS Code takes the directory from, so one spelling stands
# for all three and $XDG_CONFIG_HOME is followed on Linux.
paths = [
  "[appData]/Code - OSS/User/settings.json",
  "[appData]/Code - OSS/User/keybindings.json",
  "[appData]/Code - OSS/User/snippets/",
]

# product.json's "dataFolderName": ".vscode-oss" is the extension directory,
# the source build's equivalent of ~/.vscode. Installed extensions, not
# settings, and outside the User directory.
exclude = [
  "~/.vscode-oss/extensions/",
]

# A source build ships without the Microsoft account services, and an extension
# that signs in uses the OS credential store rather than a file here.
secret = []

# No machine_lines, for the reason the `vscode` entry gives: settings.json is a
# preferences file, and which key holds an absolute path differs per extension,
# so a list would be invented rather than found.