import { type EventEmitter } from '../../stencil-public-runtime';
import { type FormValidationState } from '../../shared/utils/form';
import type { IUploadFile } from '../../shared/utils/interfaces';
import { type FormValidationChangeDetail } from '../../shared/utils/validator';
import type { BrFeedbackState } from '../global.types';
import type { UploadErrorDetail, UploadFileDetail, UploadHandler, UploadProgressDetail, UploadValidator } from './upload.types';
/**
 * ## Design System
 *
 * @category Formulários
 * @status stable
 * @slot default - Texto personalizado para o botão de upload. Se não fornecido, será exibido "Selecione o arquivo" como texto padrão.
 *                 Use este slot para personalizar o texto do botão de acordo com o contexto do upload, por exemplo: "Anexar documentos",
 *                 "Enviar imagens", etc.
 * @slot upload-list - Permite customizar a área de listagem de arquivos. Se utilizado, substitui a lista padrão gerada pelo componente.
 * @slot label - Rótulo customizado do upload. Quando utilizado, a prop `label` é ignorada.
 * @slot helper - Texto auxiliar exibido abaixo da superfície de seleção.
 * @slot feedback - Mensagem de validação, normalmente um `br-message`.
 * @slot loading - Conteúdo exibido enquanto o handler fornecido pela aplicação envia um arquivo.
 *
 * @part container - Wrapper principal do upload.
 * @part label - Rótulo do campo de upload.
 * @part input - Elemento input de arquivo.
 * @part button - Botão de seleção de arquivo.
 * @part helper - Texto auxiliar do upload.
 * @part remove-button - Botão de remoção de arquivo.
 * @part file-list - Lista de arquivos selecionados.
 * @part feedback - Contêiner da mensagem de validação.
 * @part loading - Estado e progresso do envio assíncrono.
 */
export declare class Upload {
    private readonly fileKeys;
    private fileKeySequence;
    elementInternals: ElementInternals;
    formDisabledCallback(disabled: boolean): void;
    formResetCallback(): void;
    formStateRestoreCallback(_state: string | File | FormData | null): void;
    /**
     * Referência ao elemento host do componente.
     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
     */
    el: HTMLBrUploadElement;
    /**
     * Cache dos arquivos combinados para renderização unificada (evita recálculos desnecessários).
     */
    allFilesCached: {
        file: File | IUploadFile;
        isNew: boolean;
    }[];
    /**
     * Arquivo único quando a seleção não é múltipla.
     */
    file: File | null;
    /**
     * Evento emitido quando um arquivo é selecionado.
     * Este estado armazena os arquivos que foram selecionados pelo usuário.
     */
    filesSelected: FileList | null;
    formDisabled: boolean;
    hasFeedbackSlot: boolean;
    private dragging;
    customValidationMessage: string;
    validatorMessage: string | null;
    isValidating: boolean;
    private uploading;
    private uploadError;
    /**
     * Estado interno para armazenar os arquivos processados da prop uploadFiles.
     */
    parsedUploadFiles: IUploadFile[];
    /**
     * Identificador único do componente.
     * Quando omitido, um valor é gerado automaticamente.
     *
     * > **Padrão:** valor único gerado por generateUniqueId().
     *
     */
    customId: string;
    /**
     * Nome do campo enviado no formulário.
     */
    name?: string;
    /**
     * Tipos de arquivo permitidos (ex.: 'image/*').
     */
    accept: string;
    /**
     * Sugere a câmera usada na captura de imagem ou vídeo.
     * O navegador pode ignorar a preferência conforme dispositivo e permissões.
     */
    capture?: '' | 'user' | 'environment';
    /**
     * Rótulo exibido acima do botão de upload.
     */
    label: string;
    /**
     * Lista de arquivos já enviados (para edição ou pré-visualização).
     * Pode ser uma string JSON ou um array de objetos IUploadFile.
     */
    /** @deprecated Use `existingFiles`. */
    uploadFiles: string | IUploadFile[];
    /** Arquivos já existentes. Quando informada, tem precedência sobre `uploadFiles`. */
    existingFiles?: string | IUploadFile[];
    /**
     * Desabilita a interação com o componente.
     *
     */
    disabled: boolean;
    /**
     * Se verdadeiro, o input de upload é obrigatório antes que o formulário possa ser enviado.
     */
    readonly required: boolean;
    /**
     * Estado visual: 'info', 'warning', 'danger' ou 'success'.
     */
    state: BrFeedbackState;
    /** Estado de feedback canônico. Quando informado, tem precedência sobre `state`. */
    feedbackState?: BrFeedbackState;
    /**
     * Indica se o componente permite a seleção de múltiplos arquivos.
     * Quando definido como `true`, o usuário pode selecionar mais de um arquivo para upload.
     */
    multiple: boolean;
    /** Quantidade mínima de arquivos, incluindo arquivos já enviados. */
    minFiles: number;
    /** Quantidade máxima de arquivos. Zero significa sem limite. */
    maxFiles: number;
    /** Tamanho máximo permitido para cada arquivo, em bytes. Zero significa sem limite. */
    maxFileSize: number;
    /**
     * Regra síncrona ou assíncrona aplicada à lista de arquivos selecionados.
     * O componente valida `File[]`, mas não envia arquivos nem interpreta a
     * resposta do servidor.
     */
    readonly validator?: UploadValidator;
    /**
     * Função assíncrona opcional fornecida pela aplicação para enviar cada arquivo.
     *
     * O componente fornece o arquivo, um `AbortSignal` e uma função de progresso,
     * mas não conhece endpoint, autenticação nem formato de resposta.
     */
    readonly uploadHandler?: UploadHandler;
    /** Lista de arquivos selecionados, equivalente a `HTMLInputElement.files`. */
    files: FileList | null;
    protected filesHandler(newValue: FileList | null): void;
    protected uploadFilesHandler(newValue: string | IUploadFile[]): void;
    protected existingFilesHandler(newValue?: string | IUploadFile[]): void;
    private parseExistingFiles;
    protected filesSelectedHandler(): void;
    /**
     * Emitido quando a lista de arquivos selecionados muda.
     * @deprecated Use `input`/`change` e leia `event.target.files`.
     */
    selectedFilesChange: EventEmitter<FileList>;
    /**
     * Evento emitido quando um arquivo da lista `uploadFiles` (externos) é removido pelo usuário.
     * O objeto emitido contém os dados do arquivo removido.
     * @deprecated Use `brUploadRemove`.
     */
    brRemove: EventEmitter<IUploadFile>;
    /** Evento canônico emitido quando um arquivo existente é removido. */
    brUploadRemove: EventEmitter<IUploadFile>;
    /** Emitido quando o usuário fecha a caixa de seleção de arquivos sem escolher nada. */
    brUploadCancel: EventEmitter<void>;
    /**
     * Emitido ao iniciar e concluir a validação customizada.
     * O `detail` contém `validating`, `valid` e `message`.
     */
    brUploadValidationChange: EventEmitter<FormValidationChangeDetail>;
    /** Emitido antes de o `uploadHandler` processar um arquivo. */
    brUploadStart: EventEmitter<UploadFileDetail>;
    /** Emitido quando o `uploadHandler` informa o progresso de um arquivo. */
    brUploadProgress: EventEmitter<UploadProgressDetail>;
    /** Emitido quando o `uploadHandler` conclui um arquivo. */
    brUploadSuccess: EventEmitter<UploadFileDetail>;
    /** Emitido quando o `uploadHandler` falha ao enviar um arquivo. */
    brUploadError: EventEmitter<UploadErrorDetail>;
    componentWillLoad(): void;
    componentDidLoad(): void;
    componentDidUpdate(): void;
    disconnectedCallback(): void;
    /**
     * Retorna `true` se o valor do componente for válido, caso contrário `false`.
     * Se o componente for inválido, dispara um evento 'invalid'.
     */
    checkValidity(): Promise<boolean>;
    /**
     * Retorna `true` se o valor do componente for válido, caso contrário `false`.
     * Se for inválido, exibe a mensagem de erro padrão do navegador.
     */
    reportValidity(): Promise<boolean>;
    /**
     * Define uma mensagem de validação customizada para o upload.
     * Se a mensagem for uma string vazia, o erro customizado é limpo.
     */
    setCustomValidity(message: string): Promise<void>;
    /** Executa o validator do upload e retorna se a lista atual é válida. */
    validate(): Promise<boolean>;
    /** Retorna um snapshot serializável da Constraint Validation API. */
    getValidationState(): Promise<FormValidationState>;
    /** Cancela o envio atual iniciado pelo `uploadHandler`. */
    cancelUpload(): Promise<void>;
    private updateAllFilesCached;
    private emitFilesChange;
    private nativeInput?;
    private validationRunId;
    private uploadController?;
    private initialUploadFiles;
    private syncFormState;
    private isDisabled;
    private cancelPendingUpload;
    private uploadSelectedFiles;
    private getFileDataForForm;
    private updateValidity;
    private isAcceptedFile;
    private getCssClassMap;
    private handleRemoveFileSelection;
    private renderFilesUploaded;
    private getFileKey;
    private onInputChange;
    private handleDrop;
    private handleDragOver;
    private handleDragEnter;
    private handleDragLeave;
    private handleFileSelection;
    private readonly handleInputChange;
    private readonly handleNativeInput;
    private readonly handleNativeCancel;
    private renderUploadStatus;
    private renderUploadError;
    private renderFeedback;
    render(): any;
}