feat: add Args.option() for typed arg options

[rexxars]

Adds a new Args.option() method mirroring Flags.option(), which provides type-safe option usage:

class Deploy extends Command {
  static args = {
    env: Args.option({
      options: ['production', 'staging', 'development'] as const
    })()
  }

  async run() {
    const {args} = await this.parse(Deploy)
    // `args.env` typed as `'production' | 'staging' | 'development' | undefined`
  }
}

Setting it as required removes the undefined from the union.

[rexxars]

Updated to include stricter type parsing: I feel it is easy to assume that options like multiple: true would go alongside options, but they should be passed on the second call.

I think theoretically we could make Args.string()/Args.integer() work too, but it would require a lot more typescript overloads - let me know if that is preferable.

[rexxars]

@jfeingold35 Any thoughts on this?

[jfeingold35]

@rexxars , sorry for the delay! I'll get this reviewed shortly and talk it over with the team.

[jfeingold35]

@rexxars , the code looks clean to me. We'll do some QAing and then we can get this approved and merged. However, it would be ideal if you could have a few runtime tests, e.g.,

• can it parse one arg
• Does it play well with multiple
• Does it reject invalid args
  etc
  Also, the documentation would need to be updated as well.

[rexxars]

Will have a look. I couldn't find any documentation on Flags.option(), so wasn't sure if this was meant to be "public" or not.