docs(README): update default settings (#1488)

1 files changed, 32 insertions, 0 deletions

diff --git a/README.md b/README.md
index 6303db9d..ce70b44c 100644
--- a/README.md
+++ b/README.md
@@ -194,10 +194,13 @@ require("mason").setup({
 ## Default configuration
 
 ```lua
+---@class MasonSettings
 local DEFAULT_SETTINGS = {
+    ---@since 1.0.0
     -- The directory in which to install packages.
     install_root_dir = path.concat { vim.fn.stdpath "data", "mason" },
 
+    ---@since 1.0.0
     -- Where Mason should put its bin location in your PATH. Can be one of:
     -- - "prepend" (default, Mason's bin location is put first in PATH)
     -- - "append" (Mason's bin location is put at the end of PATH)
@@ -205,14 +208,17 @@ local DEFAULT_SETTINGS = {
     ---@type '"prepend"' | '"append"' | '"skip"'
     PATH = "prepend",
 
+    ---@since 1.0.0
     -- Controls to which degree logs are written to the log file. It's useful to set this to vim.log.levels.DEBUG when
     -- debugging issues with package installations.
     log_level = vim.log.levels.INFO,
 
+    ---@since 1.0.0
     -- Limit for the maximum amount of packages to be installed at the same time. Once this limit is reached, any further
     -- packages that are requested to be installed will be put in a queue.
     max_concurrent_installers = 4,
 
+    ---@since 1.0.0
     -- [Advanced setting]
     -- The registries to source packages from. Accepts multiple entries. Should a package with the same name exist in
     -- multiple registries, the registry listed first will be used.
@@ -220,6 +226,7 @@ local DEFAULT_SETTINGS = {
         "github:mason-org/mason-registry",
     },
 
+    ---@since 1.0.0
     -- The provider implementations to use for resolving supplementary package metadata (e.g., all available versions).
     -- Accepts multiple entries, where later entries will be used as fallback should prior providers fail.
     -- Builtin providers are:
@@ -231,6 +238,7 @@ local DEFAULT_SETTINGS = {
     },
 
     github = {
+        ---@since 1.0.0
         -- The template URL to use when downloading assets from GitHub.
         -- The placeholders are the following (in order):
         -- 1. The repository (e.g. "rust-lang/rust-analyzer")
@@ -240,9 +248,11 @@ local DEFAULT_SETTINGS = {
     },
 
     pip = {
+        ---@since 1.0.0
         -- Whether to upgrade pip to the latest version in the virtual environment before installing packages.
         upgrade_pip = false,
 
+        ---@since 1.0.0
         -- These args will be added to `pip install` calls. Note that setting extra args might impact intended behavior
         -- and is not recommended.
         --
@@ -251,50 +261,72 @@ local DEFAULT_SETTINGS = {
     },
 
     ui = {
+        ---@since 1.0.0
         -- Whether to automatically check for new versions when opening the :Mason window.
         check_outdated_packages_on_open = true,
 
+        ---@since 1.0.0
         -- The border to use for the UI window. Accepts same border values as |nvim_open_win()|.
         border = "none",
 
+        ---@since 1.0.0
         -- Width of the window. Accepts:
         -- - Integer greater than 1 for fixed width.
         -- - Float in the range of 0-1 for a percentage of screen width.
         width = 0.8,
 
+        ---@since 1.0.0
         -- Height of the window. Accepts:
         -- - Integer greater than 1 for fixed height.
         -- - Float in the range of 0-1 for a percentage of screen height.
         height = 0.9,
 
         icons = {
+            ---@since 1.0.0
             -- The list icon to use for installed packages.
             package_installed = "◍",
+            ---@since 1.0.0
             -- The list icon to use for packages that are installing, or queued for installation.
             package_pending = "◍",
+            ---@since 1.0.0
             -- The list icon to use for packages that are not installed.
             package_uninstalled = "◍",
         },
 
         keymaps = {
+            ---@since 1.0.0
             -- Keymap to expand a package
             toggle_package_expand = "<CR>",
+            ---@since 1.0.0
             -- Keymap to install the package under the current cursor position
             install_package = "i",
+            ---@since 1.0.0
             -- Keymap to reinstall/update the package under the current cursor position
             update_package = "u",
+            ---@since 1.0.0
             -- Keymap to check for new version for the package under the current cursor position
             check_package_version = "c",
+            ---@since 1.0.0
             -- Keymap to update all installed packages
             update_all_packages = "U",
+            ---@since 1.0.0
             -- Keymap to check which installed packages are outdated
             check_outdated_packages = "C",
+            ---@since 1.0.0
             -- Keymap to uninstall a package
             uninstall_package = "X",
+            ---@since 1.0.0
             -- Keymap to cancel a package installation
             cancel_installation = "<C-c>",
+            ---@since 1.0.0
             -- Keymap to apply language filter
             apply_language_filter = "<C-f>",
+            ---@since 1.1.0
+            -- Keymap to toggle viewing package installation log
+            toggle_package_install_log = "<CR>",
+            ---@since 1.8.0
+            -- Keymap to toggle the help view
+            toggle_help = "g?",
         },
     },
 }