id       = "npm-check-updates"
name     = "npm-check-updates"
homepage = "https://github.com/raineorshine/npm-check-updates"
description = "npm-check-updates upgrades your package.json dependencies to the latest versions, ignoring specified versions."
executables   = ["ncu", "npm-check-updates"]

[dotfiles]

# README, "Options are merged with the following precedence: 1. Command line
# options 2. Local Config File (current working directory) 3. Project Config
# File (next to package.json) 4. User Config File ($HOME)". The file name is
# "--configFileName <s>  Config file name. (default: .ncurc or
# .ncurc.{json,yaml,yml,js,mjs,cjs})", so every accepted spelling of the $HOME
# copy is listed; the cwd and package.json copies belong to the project.
paths = [
  "~/.ncurc",
  "~/.ncurc.json",
  "~/.ncurc.yaml",
  "~/.ncurc.yml",
  "~/.ncurc.js",
  "~/.ncurc.cjs",
  "~/.ncurc.mjs",
]

# README: "--cacheFile <path>  Filepath for the cache file. Only works with
# --cache. (default: "~/.ncu-cache.json")" — resolved registry versions, not
# configuration.
exclude = ["~/.ncu-cache.json"]

# The file holds upgrade policy: target, reject/filter lists, dep sections,
# package manager. Registry credentials stay in npm's own .npmrc.
secret = []

# Read once at startup by a process that then exits.
side_effect = false

# No machine_lines: every option in the file is an upgrade policy the user
# wants applied wherever they run ncu.

[commands]
format = 1
label = "Check dependency updates"
description = "Check package.json for newer dependency versions, optionally rewriting the file with -u. Doctor mode, custom filter functions and config-file options are left out."
quality = "ai-draft"
base = "fig:ncu"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/ncu.ts"
license = "MIT"

[[commands.field]]
id = "filter"
label = "Package filter"
type = "string"
position = 0
multiple = true
sources = ["fig"]

[[commands.field]]
id = "upgrade"
label = "Write upgrades to package.json"
type = "boolean"
option = ["--upgrade", "-u"]
effect = "overwrite"
sources = ["fig"]

[[commands.field]]
id = "target"
label = "Upgrade target"
type = "string"
option = ["--target", "-t"]
suggestions = [{ value = "latest", label = "latest" }, { value = "newest", label = "newest" }, { value = "greatest", label = "greatest" }, { value = "minor", label = "minor" }, { value = "patch", label = "patch" }]
sources = ["fig"]

[[commands.field]]
id = "dep"
label = "Dependency sections"
type = "string"
option = ["--dep"]
suggestions = [{ value = "prod", label = "prod" }, { value = "dev", label = "dev" }, { value = "optional", label = "optional" }, { value = "peer", label = "peer" }, { value = "packageManager", label = "packageManager" }]
sources = ["fig"]

[[commands.field]]
id = "reject"
label = "Exclude packages"
type = "string"
option = ["--reject", "-x"]
sources = ["fig"]

[[commands.field]]
id = "deep"
label = "Recurse into subdirectories"
type = "boolean"
option = ["--deep"]
sources = ["fig"]

[[commands.field]]
id = "global"
label = "Global packages"
type = "boolean"
option = ["--global", "-g"]
sources = ["fig"]

[[commands.field]]
id = "interactive"
label = "Interactive"
type = "boolean"
option = ["--interactive", "-i"]
sources = ["fig"]

[[commands.field]]
id = "workspaces"
label = "All workspaces"
type = "boolean"
option = ["--workspaces", "-ws"]
sources = ["fig"]

[[commands.field]]
id = "minimal"
label = "Minimal (skip satisfied)"
type = "boolean"
option = ["--minimal", "-m"]
sources = ["fig"]

[[commands.field]]
id = "peer"
label = "Respect peer dependencies"
type = "boolean"
option = ["--peer"]
sources = ["fig"]

[[commands.field]]
id = "json_upgraded"
label = "JSON of upgrades"
type = "boolean"
option = ["--jsonUpgraded"]
sources = ["fig"]

[[commands.field]]
id = "format"
label = "Output format"
type = "string"
option = ["--format"]
suggestions = [{ value = "group", label = "group" }, { value = "ownerChanged", label = "ownerChanged" }, { value = "repo", label = "repo" }, { value = "time", label = "time" }, { value = "lines", label = "lines" }]
sources = ["fig"]

[[commands.field]]
id = "package_manager"
label = "Package manager"
type = "string"
option = ["--packageManager", "-p"]
suggestions = [{ value = "npm", label = "npm" }, { value = "yarn", label = "yarn" }, { value = "pnpm", label = "pnpm" }, { value = "deno", label = "deno" }, { value = "staticRegistry", label = "staticRegistry" }]
sources = ["fig"]

[[commands.field]]
id = "registry"
label = "Registry"
type = "string"
option = ["--registry", "-r"]
sources = ["fig"]

[[commands.field]]
id = "cwd"
label = "Working directory"
type = "path"
option = ["--cwd"]
path = { kind = "directory", role = "input" }
sources = ["fig"]

[[commands.task]]
id = "check"
label = "Check updates"
fields = ["filter", "target", "dep"]
required = []

[[commands.task]]
id = "upgrade"
label = "Upgrade package.json"
fields = ["filter", "target", "reject"]
required = []
set = { upgrade = [true] }

[[commands.task]]
id = "interactive"
label = "Pick upgrades"
fields = ["target"]
required = []
set = { interactive = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["filter", "upgrade", "target", "interactive"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["dep", "reject", "deep", "global", "workspaces", "minimal", "peer", "json_upgraded", "format", "package_manager", "registry", "cwd"]