id = "ls"
name = "ls"
description = "List directory contents."
executables = ["ls"]
platforms = ["macos"]

[commands]
format = 1
label = "List directory contents"
description = "List files and directories with the common display and sort options. Colour, ACL, flag and extended-attribute options are left out."
quality = "ai-draft"
base = "fig:ls"
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/ls.ts"
license = "MIT"

[[commands.field]]
id = "paths"
label = "Paths"
type = "path"
position = 0
multiple = true
path = { kind = "any", role = "input", must_exist = true }
sources = ["fig"]

[[commands.field]]
id = "all"
label = "Include hidden files"
type = "boolean"
option = ["-a"]
sources = ["fig"]

[[commands.field]]
id = "almost_all"
label = "Hidden files except . and .."
type = "boolean"
option = ["-A"]
sources = ["fig"]

[[commands.field]]
id = "long"
label = "Long format"
type = "boolean"
option = ["-l"]
sources = ["fig"]

[[commands.field]]
id = "human"
label = "Human-readable sizes"
description = "Only has effect together with long format."
type = "boolean"
option = ["-h"]
sources = ["fig"]

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

[[commands.field]]
id = "sort_time"
label = "Sort by modification time"
type = "boolean"
option = ["-t"]
sources = ["fig"]

[[commands.field]]
id = "sort_size"
label = "Sort by size"
type = "boolean"
option = ["-S"]
sources = ["fig"]

[[commands.field]]
id = "reverse"
label = "Reverse sort order"
type = "boolean"
option = ["-r"]
sources = ["fig"]

[[commands.field]]
id = "classify"
label = "Mark file types (/ * @ ...)"
type = "boolean"
option = ["-F"]
sources = ["fig"]

[[commands.field]]
id = "one_per_line"
label = "One entry per line"
type = "boolean"
option = ["-1"]
sources = ["fig"]

[[commands.field]]
id = "directories"
label = "List directories themselves"
type = "boolean"
option = ["-d"]
sources = ["fig"]

[[commands.field]]
id = "inode"
label = "Show inode numbers"
type = "boolean"
option = ["-i"]
sources = ["fig"]

[[commands.task]]
id = "detailed"
label = "Detailed listing"
fields = ["paths", "all", "long", "human"]
set = { long = [true], human = [true] }

[[commands.task]]
id = "newest"
label = "Newest first"
fields = ["paths", "long", "sort_time"]
set = { long = [true], sort_time = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["paths", "all", "long", "human", "sort_time"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["almost_all", "reverse", "classify", "one_per_line", "directories", "inode", "recursive", "sort_size"]