def face_join(faces: 'bmesh.types.BMFace', remove: bool=True
    ) ->'bmesh.types.BMFace':
    """Joins a sequence of faces. 

    :param faces: Sequence of faces. 
    :type faces: 'bmesh.types.BMFace'
    :param remove: Remove the edges and vertices between the faces. 
    :type remove: bool
    :return:  The newly created face or None on failure. 
    """
    pass
