import os

def listar_arquivos(pasta_alvo: str) -> list[str]:
    """
    Lista todos os arquivos presentes dentro de uma pasta alvo específica.

    Args:
        pasta_alvo (str): O caminho completo ou relativo para a pasta que
                          terá seus arquivos listados.

    Returns:
        list[str]: Uma lista de strings contendo os nomes dos arquivos
                   encontrados na pasta. Retorna uma lista vazia se a pasta
                   não existir, não for um diretório, estiver vazia ou
                   ocorrer um erro.
    """
    if not os.path.exists(pasta_alvo):
        print(f"Aviso (listar_arquivos): A pasta '{pasta_alvo}' não existe.")
        return []
    if not os.path.isdir(pasta_alvo):
        print(f"Aviso (listar_arquivos): O caminho '{pasta_alvo}' não é um diretório válido.")
        return []

    try:
        arquivos_na_pasta = []
        # os.listdir retorna nomes de arquivos e diretórios.
        # Precisamos filtrar para incluir apenas arquivos.
        for item in os.listdir(pasta_alvo):
            caminho_completo_item = os.path.join(pasta_alvo, item)
            if os.path.isfile(caminho_completo_item):
                arquivos_na_pasta.append(item)
        return arquivos_na_pasta
    except Exception as e:
        print(f"Erro (listar_arquivos): Não foi possível listar arquivos em '{pasta_alvo}'. Erro: {e}")
        return []