Function matchOptions

packages/cli/src/internal/options.ts:1542–1593

(
  input: ReadonlyArray<string>,
  options: ReadonlyArray<ParseableInstruction>,
  config: CliConfig.CliConfig
)

 * arguments from `input` and a mapping between each flag and its values.
 */
const matchOptions = (
  input: ReadonlyArray<string>,
  options: ReadonlyArray<ParseableInstruction>,
  config: CliConfig.CliConfig
): Effect.Effect<
  [
    Option.Option<ValidationError.ValidationError>,
    ReadonlyArray<string>,
    HashMap.HashMap<string, ReadonlyArray<string>>
  ]
> => {
  if (Arr.isNonEmptyReadonlyArray(options)) {
    return findOptions(input, options, config).pipe(
      Effect.flatMap(([otherArgs, otherOptions, map1]) => {
        if (HashMap.isEmpty(map1)) {
          return Effect.succeed([Option.none(), input, map1] as [
            Option.Option<ValidationError.ValidationError>,
            ReadonlyArray<string>,
            HashMap.HashMap<string, ReadonlyArray<string>>
          ])
        }
        return matchOptions(otherArgs, otherOptions, config).pipe(
          Effect.map(([error, otherArgs, map2]) =>
            [error, otherArgs, merge(map1, Arr.fromIterable(map2))] as [
              Option.Option<ValidationError.ValidationError>,
              ReadonlyArray<string>,
              HashMap.HashMap<string, ReadonlyArray<string>>
            ]
          )
        )
      }),
      Effect.catchAll((e) =>
        Effect.succeed([Option.some(e), input, HashMap.empty()] as [
          Option.Option<ValidationError.ValidationError>,
          ReadonlyArray<string>,
          HashMap.HashMap<string, ReadonlyArray<string>>
        ])
      )
    )
  }
  return Arr.isEmptyReadonlyArray(input)
    ? Effect.succeed([Option.none(), Arr.empty(), HashMap.empty()] as [
      Option.Option<ValidationError.ValidationError>,
      ReadonlyArray<string>,
      HashMap.HashMap<string, ReadonlyArray<string>>
    ])
    : Effect.succeed([Option.none(), input, HashMap.empty()] as [
      Option.Option<ValidationError.ValidationError>,
      ReadonlyArray<string>,
      HashMap.HashMap<string, ReadonlyArray<string>>
    ])
}

/**
 * Returns the leftover arguments, leftover options, and a mapping between the