id       = "latexindent"
name     = "latexindent"
homepage = "https://latexindentpl.readthedocs.io/"
description = "Perl script to add indentation to LaTeX files."
executables   = ["latexindent", "latexindent.pl"]

[dotfiles]

# https://tex.org.uk/support/latexindent/documentation/latexindent.pdf — the
# manual lists XDG config, macOS Preferences, Windows LOCALAPPDATA, and the
# home-directory indentconfig.yaml/.indentconfig.yaml fallbacks.
paths = [
  "[configHome]/latexindent/indentconfig.yaml",
  "[preferences]/latexindent/indentconfig.yaml",
  "%LOCALAPPDATA%/latexindent/indentconfig.yaml",
  "~/indentconfig.yaml",
  "~/.indentconfig.yaml",
]
secret = []

[commands]
format = 1
label = "latexindent"
description = "Indent one or more LaTeX files. Output goes to the terminal unless overwrite is set. YAML settings, logging and replacement options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "manual"
kind = "manual"
url = "https://mirrors.ctan.org/support/latexindent/documentation/latexindent.pdf"
revision = "V4.0.3"
evidence = """
latexindent.pl myfile.tex
latexindent.pl myfile1.tex myfile2.tex
-w, overwrite
latexindent.pl -w myfile.tex
latexindent.pl myfile.tex --overwrite
-s, silent
latexindent.pl -s myfile.tex
-d, onlydefault
latexindent.pl -d myfile.tex
latexindent.pl -m myfile.tex
latexindent.pl -k myfile.tex
"""

[[commands.field]]
id = "files"
label = "LaTeX files"
type = "path"
position = 0
multiple = true
path = { kind = "file", role = "input" }
sources = ["manual"]

[[commands.field]]
id = "overwrite"
label = "Overwrite the files"
description = "Replace each input file with its indented version (a backup is made by default)."
type = "boolean"
option = ["--overwrite", "-w"]
effect = "overwrite"
sources = ["manual"]

[[commands.field]]
id = "silent"
label = "Silent"
type = "boolean"
option = ["-s"]
sources = ["manual"]

[[commands.field]]
id = "modifylinebreaks"
label = "Modify line breaks"
type = "boolean"
option = ["-m"]
sources = ["manual"]

[[commands.field]]
id = "onlydefault"
label = "Only default settings"
type = "boolean"
option = ["-d"]
sources = ["manual"]

[[commands.field]]
id = "check"
label = "Check only"
description = "Check whether indentation would change the text."
type = "boolean"
option = ["-k"]
sources = ["manual"]

[[commands.task]]
id = "preview"
label = "Preview indentation"
fields = ["files"]
required = ["files"]

[[commands.task]]
id = "overwrite"
label = "Indent in place"
set = { overwrite = [true] }
fields = ["files", "overwrite"]
required = ["files"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["files", "overwrite", "silent", "check"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["modifylinebreaks", "onlydefault"]