id       = "yo"
name     = "Yeoman"
homepage = "https://yeoman.io"
description = "The web's scaffolding tool for modern webapps."
icon     = "theSVG:yeoman"
executables   = ["yo"]

[dotfiles]

# yeoman-generator's `_getGlobalStorage()` builds the store path as
# `path.join(os.homedir(), '.yo-rc-global.json')`
# (yeoman/generator, src/generator.ts), so a generator's remembered answers
# land in ~/.yo-rc-global.json. The .yo-rc.json a generator writes marks the
# root of a scaffolded project and is not user-level.
paths = ["~/.yo-rc-global.json"]

exclude = []

# The global store holds prompt answers — author name, licence, framework
# choice. Nothing in it is a credential.
secret = []

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

# No machine_lines: the answers are keyed by "<generator>:<version>" and are
# exactly the preferences a user wants carried to the next machine.

[commands]
format = 1
label = "Run a Yeoman generator"
description = "Run a generator by name. Generator-specific options are not covered."
quality = "ai-draft"
base = "fig:yo"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

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

[[commands.field]]
id = "generator"
label = "Generator"
type = "string"
position = 0
suggestions = [{ value = "doctor", label = "Doctor" }]
sources = ["fig"]

[[commands.field]]
id = "force"
label = "Overwrite existing files"
type = "boolean"
option = ["--force", "-f"]
effect = "overwrite"
sources = ["fig"]

[[commands.field]]
id = "local_only"
label = "Local generators only"
type = "boolean"
option = ["--local-only"]
sources = ["fig"]

[[commands.field]]
id = "list_generators"
label = "List generators"
type = "boolean"
option = ["--generators"]
sources = ["fig"]

[[commands.task]]
id = "run"
label = "Run generator"
fields = ["generator", "force", "local_only"]
required = ["generator"]

[[commands.task]]
id = "list"
label = "List generators"
set = { list_generators = [true] }
lock = ["list_generators"]
fields = ["list_generators"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["generator", "force"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["local_only", "list_generators"]