Changelog

0.2.0 (2026-07-09)

:parse custom value parsers (#98) (bc71aa9), closes #72
allow_hyphen_values for options, plus negative numbers in num_args (#95) (44b3d5a), closes #64 #73
args_conflicts_with_subcommands for optional subcommands (#54) (bbbf42c), closes #47
Cheer.MixTask helper for building Mix tasks from Cheer commands (#99) (9af3a36)
colored help and error output (#124) (ffecec1), closes #102
default_missing_value for a flag present with no value (#122) (921e51c), closes #103
deprecation markers for options, arguments, and subcommands (#120) (8678086), closes #106
implement command-level hide (fixes documented-but-missing setting) (#78) (ddb095b), closes #60
markdown reference generation (Cheer.Reference) (#125) (2246274)
num_args for multi-value options (#52) (b784079), closes #27
positional variadic arguments (num_args on positionals) (#121) (0c23cdc), closes #104
required (one-of) param group constraint (#118) (c2c94be), closes #100
required_if_all and required_unless_all conditional-required variants (#119) (c50d3e2)
signal usage failures so callers can set an exit code (#53) (c439049), closes #49
suggest closest option name for an unknown flag (#96) (61019c7), closes #71
value_delimiter to split a single value into a list (#97) (3926b21), closes #70
warn on deprecated argument use; test: close audit coverage gaps (#127) (d7b0e7b)
wrap long help descriptions to terminal width (#123) (fb60dce), closes #101

argument-level validate and choices were never run (#91) (f5628b4)
evaluate option/argument opt values instead of storing AST (#50) (86722a8), closes #48
kebab-case option flags in bash/zsh/fish completions (#90) (791fbba), closes #65
low-severity correctness nits from the audit (#93) (44f31f9), closes #68
no spurious n-in-[] warning for single-sided validate/parse commands (#114) (fa3b7bc), closes #108
option constraints misfire on defaulted options (track user-supplied provenance) (#77) (ed6ee59), closes #59
repeated lifecycle hooks and validators silently drop all but the first (#76) (07dc4cb), closes #58
router: coerce :count env fallback and support num_args on external subcommands (#92) (3f45baf), closes #66 #67
router: external-subcommand feature parity, positional error labels, and user-fn exceptions (#116) (b0ddda3), closes #109 #110 #111

include subcommand path in usage line, drop bogus [-- <args>...] (#42) (58017ea)
render option names as kebab-case + warn on empty version (#40) (91cde25)