import { type EventEmitter } from '../../stencil-public-runtime';
import type { BrOrientation, BrProgressionType } from '../global.types';
/**
 * O `br-wizard` conduz fluxos passo a passo divididos em telas sequenciais com botões de navegação e barra de progresso.
 *
 * Insira cada tela com `br-wizard-panel` no slot padrão. Acompanhe a mudança de etapas pelo evento `brStepChange`.
 *
 * ```html
 * <br-wizard>
 *   <br-wizard-panel title-text="Identificação">
 *     <p>Primeira etapa do cadastro.</p>
 *   </br-wizard-panel>
 *   <br-wizard-panel title-text="Endereço">
 *     <p>Segunda etapa do cadastro.</p>
 *   </br-wizard-panel>
 *   <br-wizard-panel title-text="Confirmação">
 *     <p>Revise os dados antes de enviar.</p>
 *   </br-wizard-panel>
 * </br-wizard>
 * ```
 *
 * ### Quando usar
 *
 * - Formulários extensos com dependência lógica entre etapas.
 *
 * ### Quando evitar
 *
 * - Apenas indicar o status de um pedido já realizado: use `br-step`.
 * - Conteúdos independentes onde a ordem de preenchimento é livre: use `br-tab`.
 *
 * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).
 *
 * @category Navegação, Formulários, Progresso
 * @status stable
 * @slot default - Slot para os painéis de etapa (br-wizard-panel) do wizard.
 * @slot cancel-button - Conteúdo customizado do botão de cancelar. Quando utilizado, o texto padrão "Cancelar" é substituído.
 * @slot next-button - Conteúdo customizado do botão de avançar/concluir. Quando utilizado, os textos padrão "Avançar" e "Concluir" são substituídos.
 * @slot previous-button - Conteúdo customizado do botão de voltar. Quando utilizado, o texto padrão "Voltar" é substituído.
 *
 * @part form - Área do formulário do wizard.
 * @part panel - Painel ativo do wizard.
 * @part progress - Área de progresso do wizard.
 * @part content - Conteúdo do painel ativo.
 * @part buttons - Área de botões de navegação.
 */
export declare class Wizard {
    /**
     * Internals API para suporte a formulários nativos.
     */
    /**
     * Referência ao elemento host do componente.
     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
     */
    el: HTMLBrWizardElement;
    /**
     * Mensagem de status para leitores de tela (aria-live)
     */
    ariaLiveMessage: string;
    /**
     * Estado collapsed para recolher/expandir barra de progresso (mobile)
     */
    collapsed: boolean;
    /**
     * Etapa atual sendo exibida.
     * Gerenciado internamente pelo componente.
     */
    currentStep: number;
    /** Estado mobile para detecção responsiva */
    isMobile: boolean;
    /**
     * Lista de painéis filhos (br-wizard-panel).
     * Descobertos automaticamente via slot.
     */
    panels: HTMLElement[];
    /** Etapa atual (numeração 1-indexada). Reflete para atributo step. */
    step: number;
    /**
     * Índice da etapa inicial do wizard.
     * Define qual etapa será exibida ao carregar o componente.
     * A numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).
     * Valores inválidos usam 1.
     * @deprecated Use `initialIndex`.
     */
    initialStep: number;
    /** Índice inicial zero-based. Quando informado, tem precedência sobre `initialStep`; valores inválidos usam 0. */
    initialIndex?: number;
    /** Índice atual zero-based para controle externo opcional. */
    currentIndex?: number;
    /**
     * Orientação visual do wizard.
     * Define se os indicadores de progresso serão exibidos horizontalmente ou verticalmente.
     */
    orientation: BrOrientation;
    /**
     * Tipo de progressão entre etapas.
     * - `linear`: O usuário deve completar cada etapa sequencialmente. Não é possível pular etapas futuras.
     * - `nonlinear`: O usuário pode navegar livremente entre qualquer etapa.
     */
    progressionType: BrProgressionType;
    /**
     * Identificador único do componente.
     * Quando omitido, um valor é gerado automaticamente.
     *
     * > **Padrão:** valor único gerado por generateUniqueId().
     *
     */
    customId: string;
    private get effectiveOrientation();
    private get effectiveProgressionType();
    private get effectiveInitialIndex();
    private get effectiveInitialStep();
    /**
     * Observa mudanças no tipo de progressão.
     * Atualiza a navegação dos painéis quando muda entre linear/nonlinear.
     */
    handleProgressionTypeChange(): void;
    /**
     * Observa mudanças na etapa inicial.
     * Reinicializa o wizard quando a prop initialStep é alterada externamente.
     */
    handleInitialStepChange(): Promise<void>;
    handleInitialIndexChange(): Promise<void>;
    handleCurrentIndexChange(newIndex?: number): Promise<void>;
    handleStepChangeProp(newStep?: number): Promise<void>;
    /**
     * Observa mudanças na etapa atual (fonte única de verdade).
     * Sincroniza com br-step, atualiza painéis, anuncia mudança e move foco.
     * @param newStep - Nova etapa
     * @param oldStep - Etapa anterior
     */
    handleCurrentStepChange(newStep: number, oldStep: number): Promise<void>;
    /**
     * Evento emitido APÓS mudar de etapa com sucesso.
     *
     * Este evento é disparado independente da origem da navegação:
     * - Botões "Avançar" ou "Voltar"
     * - Click direto em um step do indicador de progresso
     * - Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)
     */
    brWizardStepChange: EventEmitter<number>;
    /**
     * Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).
     *
     * Comportamento:
     * - Disparado apenas ao AVANÇAR (targetStep > currentStep)
     * - Não é disparado ao VOLTAR (targetStep < currentStep)
     * - Funciona tanto para cliques nos botões quanto para cliques diretos nos steps
     * - Pode ser cancelado com `event.preventDefault()` para bloquear a navegação
     */
    brWizardBeforeStepChange: EventEmitter<number>;
    /**
     * Evento emitido ao concluir o wizard (última etapa).
     */
    brWizardComplete: EventEmitter<void>;
    /**
     * Evento emitido ao cancelar o wizard.
     */
    brWizardCancel: EventEmitter<void>;
    /**
     * Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).
     * Emite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.
     * Use getCurrentStepIndex() para obter o contexto da etapa atual.
     */
    brWizardNavigationBlocked: EventEmitter<string>;
    /**
     * Lifecycle: limpa listeners quando componente é removido.
     */
    disconnectedCallback(): void;
    /**
     * Lifecycle: inicializa painéis antes da renderização.
     */
    componentWillLoad(): void;
    /**
     * Lifecycle: carrega painéis e configura estado inicial.
     * Sincroniza com br-step, atualiza painéis e configura detecção mobile.
     */
    componentDidLoad(): Promise<void>;
    /**
     * Detecta quando o slot muda (painéis adicionados/removidos dinamicamente).
     * Redescobre os painéis e ressincroniza o estado.
     * @param event - Evento slotchange
     */
    handleSlotChange(event: Event): Promise<void>;
    /**
     * Detecta quando o br-step muda de etapa ativa.
     * Valida e sincroniza a navegação com o componente interno br-step.
     * @param event - Evento customizado do br-step
     */
    handleStepChange(event: CustomEvent<{
        activeStep: number;
    }>): Promise<void>;
    /**
     * Avança para a próxima etapa.
     * Executa validação via evento `brWizardBeforeStepChange` antes de navegar.
     * @returns Promise<boolean> - true se navegou com sucesso, false se bloqueado
     */
    nextStep(): Promise<boolean>;
    /** Avança para a próxima etapa. */
    next(): Promise<boolean>;
    /**
     * Volta para a etapa anterior.
     * Não executa validação ao retornar.
     * @returns Promise<boolean> - true se navegou com sucesso, false se bloqueado
     */
    previousStep(): Promise<boolean>;
    /** Retorna para a etapa anterior. */
    previous(): Promise<boolean>;
    /**
     * Navega para uma etapa específica.
     * Executa validação se estiver avançando (etapa alvo > etapa atual).
     * @param stepNumber - Número da etapa de destino (numeração começa em 1)
     * @returns Promise<boolean> - true se navegou com sucesso, false se bloqueado
     */
    goToStep(stepNumber: number): Promise<boolean>;
    /**
     * Retorna à primeira etapa do wizard.
     * Não executa validação (útil para reiniciar o fluxo).
     * @returns Promise<void>
     */
    reset(): Promise<void>;
    /**
     * Retorna o elemento HTML do painel ativo no momento.
     * @returns Promise<HTMLElement | null>
     */
    getCurrentStep(): Promise<HTMLElement | null>;
    /**
     * Retorna todos os painéis do wizard.
     * @returns Promise<HTMLElement[]>
     */
    getAllSteps(): Promise<HTMLElement[]>;
    /**
     * Retorna um painel específico pelo índice.
     * @param stepNumber - Número da etapa (numeração começa em 1)
     * @returns Promise<HTMLElement | null>
     */
    getStepByIndex(stepNumber: number): Promise<HTMLElement | null>;
    /**
     * Retorna o índice (número) da etapa atual.
     * A numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).
     * @returns Promise<number>
     */
    getCurrentStepIndex(): Promise<number>;
    /**
     * Retorna o número total de etapas do wizard.
     * @returns Promise<number>
     */
    getTotalSteps(): Promise<number>;
    /**
     * Referência ao componente br-step.
     */
    private stepRef;
    /**
     * Flag para evitar loop quando sincronizamos programaticamente com br-step.
     */
    private isSyncingWithStep;
    /**
     * Instância do Swipe para gestos mobile na barra de progresso.
     */
    private progressBarSwipe;
    /**
     * Referência ao elemento DOM da barra de progresso.
     */
    private progressBarRef;
    /**
     * Referência ao elemento DOM do formulário/painel ativo.
     */
    private formRef;
    /**
     * Timer para limpar mensagens aria-live.
     */
    private ariaLiveTimeout;
    /**
     * Tempo de espera para limpar mensagens aria-live (em ms).
     */
    private ARIA_LIVE_CLEANUP_DELAY;
    /**
     * Método privado central que gerencia toda a navegação com validação.
     *
     * Comportamento unificado para linear e nonlinear:
     * - Linear: Valida ao avançar, não permite pular steps
     * - Nonlinear: Valida ao avançar, permite pular steps livremente
     *
     * @param targetStep - Número da etapa de destino (numeração começa em 1)
     * @param skipValidation - Se true, pula validação (útil para reset/programático)
     * @returns Promise<boolean> - true se navegou com sucesso, false se bloqueado
     */
    private navigateToStep;
    /**
     * Sincroniza estado do wizard com o br-step.
     *
     * O br-step já gerencia completamente os atributos 'active' via componentShouldUpdate
     * e requestAnimationFrame, então apenas chamamos os métodos de navegação dele.
     */
    private syncWithBrStep;
    /**
     * Descobre painéis filhos usando assigned elements do slot.
     * @param slot - Elemento slot do shadow DOM
     */
    private discoverPanelsFromSlot;
    /**
     * Atualiza a lista de painéis somente quando a composição realmente mudou.
     * Evita uma re-renderização redundante durante `componentDidLoad()`.
     */
    private setPanels;
    /**
     * Atualiza estados de todos os painéis.
     * Define o índice e o estado ativo de cada painel.
     */
    private updatePanels;
    /**
     * Define etapa inicial baseada na prop initialStep.
     * Garante que o valor esteja dentro dos limites válidos.
     */
    private setInitialStep;
    /**
     * Anuncia mensagem para leitores de tela via aria-live.
     * Limpa automaticamente após 5 segundos para evitar poluição.
     * @param message - Mensagem a ser anunciada
     */
    private announceToScreenReader;
    /**
     * Anuncia mudança de etapa para leitores de tela.
     * Informa direção da navegação e progresso atual.
     * @param newStep - Nova etapa
     * @param oldStep - Etapa anterior
     */
    private announceStepChange;
    /**
     * Limpa o timeout de mensagens aria-live.
     */
    private clearAriaLiveTimeout;
    /**
     * Move foco para o primeiro elemento do painel ativo.
     *
     */
    private setFocusOnActivePanel;
    /**
     * Configura detecção de viewport mobile.
     * Ativa listeners de resize e configura gestos swipe.
     */
    private setupMobileDetection;
    /**
     * Remove listeners de detecção mobile.
     */
    private cleanupMobileDetection;
    /**
     * Handler de resize da janela.
     * Alterna entre modos mobile/desktop e configura/limpa gestos swipe.
     */
    private handleResize;
    /**
     * Configura gestos swipe para mobile.
     */
    private setupSwipeListeners;
    /**
     * Remove listeners de gestos swipe.
     */
    private cleanupSwipeListeners;
    /**
     * Handler de toque no formulário.
     * Recolhe automaticamente a barra de progresso.
     */
    private handleFormTouchStart;
    /**
     * Recolhe a barra de progresso (mobile).
     * Adiciona o atributo 'collapsed' ao host.
     */
    private collapseSteps;
    /**
     * Expande a barra de progresso (mobile).
     * Remove o atributo 'collapsed' do host.
     */
    private expandSteps;
    /**
     * Handler do botão "Avançar" ou "Concluir".
     * Se for a última etapa, valida e emite evento de conclusão.
     * Caso contrário, avança para a próxima etapa.
     */
    private handleNext;
    /**
     * Handler do botão "Voltar".
     * Navega para a etapa anterior.
     */
    private handlePrevious;
    /**
     * Handler do botão "Cancelar".
     * Emite evento de cancelamento do wizard.
     */
    private handleCancel;
    /**
     * Retorna classes CSS do container principal.
     * @returns CssClassMap - Mapa de classes CSS
     */
    private getHostClassMap;
    /**
     * Renderiza indicadores de progresso usando br-step.
     * @returns JSX.Element | null - Elemento de progresso ou null se não houver painéis
     */
    private renderProgress;
    /**
     * Renderiza conteúdo dos painéis via slot.
     * @returns JSX.Element - Container com slot dos painéis
     */
    private renderPanelContent;
    /**
     * Renderiza botões de navegação do wizard.
     * Adapta-se ao contexto: primeira etapa, última etapa, mobile/desktop.
     * @returns JSX.Element - Container com botões de navegação
     */
    private renderPanelButtons;
    /**
     * Renderiza região de anúncios para leitores de tela.
     * Usa aria-live para comunicar mudanças de estado de forma acessível.
     * @returns JSX.Element - Elemento sr-only com aria-live
     */
    private renderAriaLiveRegion;
    /**
     * Método de renderização principal do componente.
     * Monta a estrutura completa do wizard com acessibilidade integrada.
     * @returns JSX.Element - Estrutura completa do wizard
     */
    render(): any;
}