id       = "vue"
name     = "Vue CLI"
homepage = "https://cli.vuejs.org"
description = "Standard Tooling for Vue.js Development."
icon     = "SimpleIcons:vuedotjs"
executables   = ["vue"]

[dotfiles]

# https://cli.vuejs.org/guide/creating-a-project.html — "Saved presets will be
# stored in a JSON file named .vuerc in your user home directory. If you wish
# to modify saved presets / options, you can do so by editing this file … you
# may also be prompted to select a preferred package manager, or use the Taobao
# npm registry mirror … Your choices will also be saved in ~/.vuerc."
#
# packages/@vue/cli/lib/util/rcPath.js is the exact order:
#   VUE_CLI_CONFIG_PATH, then $XDG_CONFIG_HOME/vue/.vuerc *when that variable
#   is set* (it is not defaulted to ~/.config), then path.join(homedir(), file).
# The same file's migrateWindowsConfigPath() moves a %APPDATA%\vue\.vuerc left
# by 3.0.0-rc.7 back to the home directory — "we are reverting it to keep
# consistency across OSes" — so Windows resolves to the home spelling too and
# no %APPDATA% path is listed.
paths = [
  "~/.vuerc",
  "~/.config/vue/.vuerc",
]

exclude = []

# packages/@vue/cli/lib/options.js validates the whole document:
# latestVersion, lastChecked, packageManager, useTaobaoRegistry and presets.
# Nothing in it authenticates anything — publishing goes through npm's own
# credentials.
secret = []

# Read at the start of a `vue` invocation and rewritten before it exits.
side_effect = false

# No machine_lines: presets, packageManager and useTaobaoRegistry are exactly
# the choices a user wants on the next machine. latestVersion/lastChecked are
# the update check's own bookkeeping, refreshed on the next run either way.

[commands]
format = 1
label = "Vue CLI"
description = "Create a project or serve a single component with the legacy Vue CLI. Plugin, inspect and upgrade commands are left out."
quality = "ai-draft"
base = "fig:vue"
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/vue.ts"
license = "MIT"

[[commands.subcommand]]
path = ["create"]
label = "Create a project"
description = "Scaffold a new Vue project."

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

[[commands.subcommand.field]]
id = "app_name"
label = "Project name"
description = "Directory to create the project in."
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.field]]
id = "preset"
label = "Preset"
description = "Saved or remote preset name."
type = "string"
option = ["--preset", "-p"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "default"
label = "Use default preset"
type = "boolean"
option = ["--default", "-d"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "package_manager"
label = "Package manager"
description = "npm client used to install dependencies, e.g. npm, yarn or pnpm."
type = "string"
option = ["--packageManager", "-m"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "registry"
label = "npm registry"
type = "url"
option = ["--registry", "-r"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "no_git"
label = "Skip git initialization"
type = "boolean"
option = ["--no-git", "-n"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "git_message"
label = "Force git init with message"
type = "string"
option = ["--git", "-g"]
sources = ["fig"]

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

[[commands.subcommand.field]]
id = "merge"
label = "Merge into existing directory"
type = "boolean"
option = ["--merge"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "default"
label = "Create with defaults"
fields = ["app_name", "default"]
required = ["app_name"]

[[commands.subcommand.task]]
id = "preset"
label = "Create from preset"
fields = ["app_name", "preset", "package_manager"]
required = ["app_name", "preset"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["app_name", "preset", "default", "package_manager"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["registry", "git_message", "merge", "no_git", "force"]

[[commands.subcommand]]
path = ["serve"]
label = "Serve a file"
description = "Zero-config dev server for one file."

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

[[commands.subcommand.field]]
id = "entry"
label = "Entry file"
description = ".js or .vue file to serve."
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["fig"]

[[commands.subcommand.field]]
id = "open"
label = "Open browser"
type = "boolean"
option = ["--open", "-o"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "copy"
label = "Copy URL to clipboard"
type = "boolean"
option = ["--copy", "-c"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port", "-p"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "serve"
label = "Serve a component"
fields = ["entry", "open", "port"]
required = ["entry"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["entry", "open", "port"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["copy"]