id       = "vivid"
name     = "vivid"
homepage = "https://github.com/sharkdp/vivid"
description = "A generator for the LS_COLORS environment variable."
executables   = ["vivid"]

[dotfiles]

# The project's official README documents custom filetype databases under
# ~/.config/vivid on POSIX systems and %APPDATA%/vivid on Windows; custom
# themes live in the themes subdirectory of each location. The POSIX fallback
# is written literally because vivid documents $XDG_CONFIG_HOME as an optional
# override, while [configHome] would incorrectly become macOS Application
# Support when that variable is unset.
# https://github.com/sharkdp/vivid/blob/master/README.md
paths = [
  "~/.config/vivid/",
  "%APPDATA%/vivid/",
]
secret = []

[commands]
format = 1
label = "Generate LS_COLORS"
description = "Generate an LS_COLORS expression from a theme, or preview a theme. Run `vivid themes` in a terminal to list theme names."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/sharkdp/vivid/blob/master/src/main.rs"
revision = "master 2026-10-27"
evidence = """-m, --color-mode <mode>  Type of ANSI colors to be used [possible values: 8-bit, 24-bit] [default: 24-bit]
-d, --database <path>  Path to filetypes database (filetypes.yml)
generate  Generate a LS_COLORS expression
preview  Preview a given theme
themes  Prints list of available themes
[theme]  Name of the color theme"""

[[commands.field]]
id = "color_mode"
label = "Color mode"
type = "enum"
option = ["--color-mode", "-m"]
choices = [{ value = "24-bit", label = "24-bit (true color)" }, { value = "8-bit", label = "8-bit (256 colors)" }]
observed_default = "24-bit"
sources = ["help"]

[[commands.field]]
id = "database"
label = "Filetypes database"
type = "path"
option = ["--database", "-d"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["help"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["color_mode", "database"]

[[commands.subcommand]]
path = ["generate"]
label = "Generate LS_COLORS"
description = "Print an LS_COLORS expression for a theme."

[[commands.subcommand.source]]
id = "help"
kind = "help"
url = "https://github.com/sharkdp/vivid/blob/master/src/main.rs"
revision = "master 2026-10-27"
evidence = """generate  Generate a LS_COLORS expression
[theme]  Name of the color theme"""

[[commands.subcommand.field]]
id = "theme"
label = "Theme"
description = "Theme name (see `vivid themes`) or path to a theme YAML file."
type = "string"
position = 0
min = 1
sources = ["help"]

[[commands.subcommand.task]]
id = "generate"
label = "Generate for a theme"
fields = ["theme"]
required = ["theme"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["theme"]

[[commands.subcommand]]
path = ["preview"]
label = "Preview a theme"
description = "Show a preview of a theme."

[[commands.subcommand.source]]
id = "help"
kind = "help"
url = "https://github.com/sharkdp/vivid/blob/master/src/main.rs"
revision = "master 2026-10-27"
evidence = """preview  Preview a given theme
[theme]  Name of the color theme"""

[[commands.subcommand.field]]
id = "theme"
label = "Theme"
type = "string"
position = 0
min = 1
sources = ["help"]

[[commands.subcommand.task]]
id = "preview"
label = "Preview a theme"
fields = ["theme"]
required = ["theme"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["theme"]