@giro-ds/react 3.0.7 → 5.0.0

package/dist/index.d.ts

@@ -1,1496 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
-import React__default, { ReactNode, ReactElement, CSSProperties } from 'react';
-
-type Size = 'sm' | 'lg';
-type Variant = 'filled' | 'outlined' | 'text';
-type TextVariant = 'neutral' | 'brand' | 'color' | 'success' | 'alert';
-type Side = 'top' | 'right' | 'bottom' | 'left';
-type Align = 'start' | 'center' | 'end';
-type Position = 'right' | 'left' | 'both';
-type Locale = 'pt-br' | 'en-us';
-interface BaseProps {
-    id?: string;
-    className?: string;
-    disabled?: boolean;
-}
-
-/**
- * Props do componente Avatar
- * @example
- * ```tsx
- * <Avatar icon={<UserIcon />} size="lg" />
- * ```
- * @example
- * ```tsx
- * <Avatar
- *   icon={<ProfileIcon />}
- *   size="sm"
- *   className="custom-avatar"
- * />
- * ```
- */
-interface AvatarProps extends BaseProps {
-    /** Ícone ou conteúdo a ser exibido no avatar */
-    icon: React$1.ReactNode;
-    /** Tamanho do avatar */
-    size?: Size;
-}
-
-declare let Avatar: ({ id, icon, size, className, ...rest }: AvatarProps) => react_jsx_runtime.JSX.Element;
-
-/** Tipos de badge suportados */
-type BadgeType = 'notification' | 'status';
-/** Valores possíveis para exibição no badge */
-type BadgeValue = number | string | null;
-/**
- * Props do componente Badge
- * @example
- * ```tsx
- * <Badge type="notification" badgeValue={5}>
- *   <IconButton icon={<BellIcon />} />
- * </Badge>
- * ```
- * @example
- * ```tsx
- * <Badge
- *   type="status"
- *   badgeValue="novo"
- *   aria-label="Novo item disponível"
- * >
- *   <Avatar icon={<UserIcon />} />
- * </Badge>
- * ```
- */
-interface BadgeProps extends BaseProps {
-    /** Tipo de badge (notificação ou status) */
-    type: BadgeType;
-    /** Conteúdo a ser envolvido pelo badge */
-    children?: ReactNode;
-    /** Valor a ser exibido no badge (número, texto ou null) */
-    badgeValue?: BadgeValue;
-    /** Valor máximo a ser exibido (ex: 99+ quando badgeValue > maxValue) */
-    maxValue?: number;
-    /** Label acessível para leitores de tela */
-    'aria-label'?: string;
-}
-
-declare const Badge: React__default.FC<BadgeProps>;
-
-/**
- * Props do componente Button
- * @example
- * ```tsx
- * <Button variant="filled" size="lg" onClick={handleClick}>
- *   Clique aqui
- * </Button>
- * ```
- * @example
- * ```tsx
- * <Button
- *   variant="outlined"
- *   icon={<Icon />}
- *   iconPosition="left"
- *   loading={isLoading}
- * >
- *   Salvar
- * </Button>
- * ```
- */
-interface ButtonProps extends BaseProps, React__default.HTMLAttributes<HTMLElement> {
-    /** Elemento customizado a ser renderizado (ex: 'a', Link do React Router) */
-    as?: React__default.ElementType;
-    /** Conteúdo do botão */
-    children?: React__default.ReactNode;
-    /** Variante visual do botão */
-    variant?: Variant;
-    /** Define se o botão exibe apenas ícone (sem texto) */
-    iconOnly?: boolean;
-    /** Posição do ícone em relação ao texto */
-    iconPosition?: Position;
-    /** URL de destino quando usado como link (renderiza <a>) */
-    href?: string;
-    /** Rota de destino para roteadores (ex: React Router) */
-    to?: string;
-    /** Define se o link abre em nova aba */
-    external?: boolean;
-    /** Atributo target do HTML para links */
-    target?: string;
-    /** Atributo rel do HTML para links */
-    rel?: string;
-    /** Tipo HTML do botão */
-    type?: 'button' | 'submit' | 'reset';
-    /** Tamanho do botão */
-    size?: Size;
-    /** Ícone a ser exibido no botão */
-    icon?: React__default.ReactNode;
-    /** Define se o botão ocupa 100% da largura do container */
-    fullWidth?: boolean;
-    /** Label acessível para leitores de tela */
-    ariaLabel?: string;
-    /** Estado de carregamento (exibe spinner) */
-    loading?: boolean;
-}
-
-declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLElement>>;
-
-/** Formatos de exibição de data disponíveis */
-type DateFormat = 'dd/mm/yyyy' | 'mm/dd/yyyy';
-/**
- * Representa um dia no calendário
- */
-interface DayItem {
-    /** Tipo do item (sempre 'day') */
-    type: 'day';
-    /** Chave única para renderização */
-    key: number;
-    /** Número do dia */
-    day: number;
-    /** Objeto Date completo */
-    date: Date;
-    /** Indica se é o dia atual */
-    isToday: boolean;
-    /** Indica se o dia está selecionado */
-    isSelected: boolean;
-    /** Label acessível do dia */
-    label: string;
-}
-/**
- * Representa um espaço vazio no grid do calendário
- */
-interface EmptyItem {
-    /** Tipo do item (sempre 'empty') */
-    type: 'empty';
-    /** Chave única para renderização */
-    key: string;
-}
-/** Item do calendário (pode ser um dia ou espaço vazio) */
-type CalendarItem = DayItem | EmptyItem;
-/**
- * Representa um ano na visualização de seleção de ano
- */
-interface YearItem {
-    /** Número do ano */
-    year: number;
-    /** Indica se é o ano atual */
-    isCurrent: boolean;
-    /** Chave única para renderização */
-    key: number;
-}
-/**
- * Props do componente Calendar
- * @example
- * ```tsx
- * <Calendar
- *   currentDate={new Date()}
- *   onDateChange={(date) => console.log(date)}
- *   locale="pt-br"
- * />
- * ```
- * @example
- * ```tsx
- * <Calendar
- *   currentDate={new Date()}
- *   selectedDate={selectedDate}
- *   onDaySelect={handleDaySelect}
- *   minDate={new Date('2024-01-01')}
- *   maxDate={new Date('2024-12-31')}
- *   format="dd/mm/yyyy"
- * />
- * ```
- */
-interface CalendarProps extends BaseProps {
-    /** Data do dia atual */
-    currentDate: Date | null;
-    /** Dia selecionado pelo usuário */
-    selectedDate?: Date | null;
-    /** Callback executado quando a data escolhida é alterada: (date) => void */
-    onDateChange?: (date: Date) => void;
-    /** Callback executado quando um dia é selecionado: (date) => void */
-    onDaySelect?: (date: Date) => void;
-    /** Callback executado ao limpar a seleção: () => void */
-    onClear?: () => void;
-    /** Data mínima selecionável */
-    minDate?: Date;
-    /** Data máxima selecionável */
-    maxDate?: Date;
-    /** Locale do calendário */
-    locale?: Locale;
-    /** Formato de exibição da data */
-    format?: DateFormat;
-}
-
-declare const MemoizedCalendar: React__default.NamedExoticComponent<CalendarProps>;
-
-/**
- * Props do componente Callout
- * @example
- * ```tsx
- * <Callout
- *   type="success"
- *   title="Sucesso!"
- *   text="Operação realizada com sucesso"
- *   icon={<CheckIcon />}
- * />
- * ```
- * @example
- * ```tsx
- * <Callout
- *   type="alert"
- *   title="Atenção"
- *   text="Verifique os campos obrigatórios"
- * />
- * ```
- */
-interface CalloutProps extends BaseProps {
-    /** Tipo visual do callout */
-    type?: TextVariant;
-    /** Título principal do callout (texto em destaque) */
-    title?: string | null;
-    /** Texto descritivo do callout */
-    text?: string;
-    /** Ícone a ser exibido no callout */
-    icon?: React$1.ReactNode;
-    /** Props adicionais para o elemento div */
-    [key: string]: any;
-}
-
-declare const Callout: React__default.FC<CalloutProps>;
-
-/**
- * Props do componente Checkbox
- * @example
- * ```tsx
- * <Checkbox
- *   label="Aceito os termos"
- *   checked={accepted}
- *   onCheckedChange={setAccepted}
- * />
- * ```
- * @example
- * ```tsx
- * <Checkbox
- *   label="Selecionar todos"
- *   indeterminate={someSelected}
- *   onCheckedChange={handleSelectAll}
- *   disabled={isLoading}
- * />
- * ```
- */
-interface CheckboxProps extends BaseProps {
-    /** Label ou conteúdo a ser exibido ao lado do checkbox */
-    label?: React__default.ReactNode;
-    /** Callback executado quando o estado muda: (checked) => void */
-    onCheckedChange?: (checked: boolean) => void;
-    /** Estado inicial (modo não controlado) */
-    defaultChecked?: boolean;
-    /** Estado atual (modo controlado) */
-    checked?: boolean;
-    /** Estado indeterminado (usado em selecionar todos com seleção parcial) */
-    indeterminate?: boolean;
-}
-
-declare const Checkbox: React$1.FC<CheckboxProps>;
-
-/**
- * Props do componente Chips
- * @example
- * ```tsx
- * <Chips
- *   type="success"
- *   title="Ativo"
- *   leftIcon={<CheckIcon />}
- * />
- * ```
- * @example
- * ```tsx
- * <Chips
- *   type="brand"
- *   title="Novo"
- *   rightIcon={<CloseIcon />}
- *   disabled={false}
- * />
- * ```
- */
-interface ChipsProps extends BaseProps {
-    /** Tipo visual do chip */
-    type?: TextVariant;
-    /** Texto a ser exibido dentro do chip */
-    title: string;
-    /** Ícone posicionado à esquerda do texto */
-    leftIcon?: React$1.ReactNode;
-    /** Ícone posicionado à direita do texto */
-    rightIcon?: React$1.ReactNode;
-    /** Props adicionais para o elemento div */
-    [key: string]: any;
-}
-
-declare const MemoizedChips: React__default.NamedExoticComponent<ChipsProps>;
-
-/**
- * Props do componente Container
- * @example
- * ```tsx
- * <Container>
- *   <h1>Conteúdo da página</h1>
- *   <p>Texto dentro do container</p>
- * </Container>
- * ```
- */
-interface ContainerProps {
-    /** Conteúdo a ser renderizado dentro do container */
-    children: React__default.ReactNode;
-}
-
-declare function Container({ children }: ContainerProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Props do componente DatePicker
- * @example
- * ```tsx
- * <DatePicker
- *   label="Data de nascimento"
- *   value={birthDate}
- *   onChange={setBirthDate}
- *   locale="pt-br"
- * />
- * ```
- * @example
- * ```tsx
- * <DatePicker
- *   label="Data de início"
- *   required
- *   helperText="Selecione a data de início do projeto"
- *   minDate={new Date()}
- *   calendarPosition="right"
- *   error={errorMessage}
- * />
- * ```
- */
-interface DatePickerProps extends BaseProps {
-    /** Locale para formatação da data */
-    locale?: Locale;
-    /** Posição do calendário em relação ao campo */
-    calendarPosition?: Position;
-    /** Texto de ajuda exibido abaixo do campo */
-    helperText?: string;
-    /** Define se o campo é obrigatório */
-    required?: boolean;
-    /** Label do campo de data */
-    label?: string;
-    /** Valor controlado da data */
-    value?: Date | null;
-    /** Valor inicial para modo não controlado */
-    defaultValue?: Date | null;
-    /** Callback executado quando a data muda: (date) => void */
-    onChange?: (date: Date | null) => void;
-    /** Mensagem de erro a ser exibida */
-    error?: string;
-    /** Data mínima selecionável */
-    minDate?: Date;
-    /** Data máxima selecionável */
-    maxDate?: Date;
-    /** ID para testes automatizados */
-    'data-testid'?: string;
-}
-
-declare const _default$1: React__default.NamedExoticComponent<DatePickerProps>;
-
-/**
- * Props do componente Dialog
- * @example
- * ```tsx
- * <Dialog
- *   show={isOpen}
- *   title="Confirmar exclusão"
- *   text="Tem certeza que deseja excluir este item?"
- *   textConfirm="Excluir"
- *   textCancel="Cancelar"
- *   fnConfirm={handleDelete}
- *   fnCancel={handleCancel}
- *   onClose={handleClose}
- * />
- * ```
- * @example
- * ```tsx
- * <Dialog
- *   show={showDialog}
- *   title="Informação"
- *   onClose={() => setShowDialog(false)}
- * >
- *   <p>Conteúdo customizado do dialog</p>
- * </Dialog>
- * ```
- */
-interface DialogProps extends BaseProps {
-    /** Conteúdo customizado do dialog */
-    children?: ReactNode;
-    /** Define se o dialog está visível */
-    show: boolean;
-    /** Título exibido no cabeçalho do dialog */
-    title: string;
-    /** Texto ou conteúdo do corpo do dialog */
-    text?: ReactNode;
-    /** Texto do botão de confirmação */
-    textConfirm?: string;
-    /** Texto do botão de cancelamento */
-    textCancel?: string;
-    /** Callback executado ao confirmar: () => void */
-    fnConfirm?: () => void;
-    /** Callback executado ao cancelar: () => void */
-    fnCancel?: () => void;
-    /** Callback executado ao fechar o dialog: () => void */
-    onClose?: () => void;
-}
-
-declare const MemoizedDialog: React__default.NamedExoticComponent<DialogProps>;
-
-/**
- * Props do componente Drawer
- * @example
- * ```tsx
- * <Drawer
- *   isOpen={isDrawerOpen}
- *   onClose={handleClose}
- *   title="Menu"
- * >
- *   <nav>
- *     <a href="/home">Home</a>
- *     <a href="/about">Sobre</a>
- *   </nav>
- * </Drawer>
- * ```
- * @example
- * ```tsx
- * <Drawer
- *   isOpen={showDrawer}
- *   onClose={() => setShowDrawer(false)}
- *   title="Configurações"
- *   customWidth="400px"
- *   closeOnOverlayClick={true}
- *   closeOnEscape={true}
- * >
- *   <Settings />
- * </Drawer>
- * ```
- */
-interface DrawerProps extends BaseProps {
-    /** Conteúdo a ser exibido dentro do drawer */
-    children?: ReactNode;
-    /** Largura customizada do drawer (ex: '400px', '50%') */
-    customWidth?: string;
-    /** Callback executado ao fechar o drawer: () => void */
-    onClose: () => void;
-    /** Título exibido no cabeçalho do drawer */
-    title?: string;
-    /** Define se o drawer está aberto */
-    isOpen: boolean;
-    /** Callback executado ao abrir o drawer: () => void */
-    onOpen?: () => void;
-    /** Callback executado ao clicar no overlay: () => void */
-    onOverlayClick?: () => void;
-    /** Define se o drawer fecha ao clicar no overlay */
-    closeOnOverlayClick?: boolean;
-    /** Define se o drawer fecha ao pressionar ESC */
-    closeOnEscape?: boolean;
-}
-
-/**
- * Componente Drawer do Zanthus Design System
- * Implementa um painel lateral deslizante com overlay
- * Segue padrões WCAG 2.1 AA para acessibilidade
- */
-declare const Drawer: React__default.FC<DrawerProps>;
-
-/**
- * Representa um item individual do dropdown
- */
-interface DropdownItem {
-    /** ID único do item (será gerado automaticamente se não fornecido) */
-    id?: string;
-    /** Texto principal do item */
-    text: string;
-    /** Texto secundário/descrição do item */
-    subText?: string;
-    /** Ícone do item */
-    icon?: React__default.ReactNode;
-    /** Define se o item está desabilitado */
-    disabled?: boolean;
-}
-/** Tipos de dropdown disponíveis */
-type DropdownType = 'text' | 'checkbox' | 'icon';
-/**
- * Props do componente Dropdown
- * @example
- * ```tsx
- * <Dropdown
- *   items={[
- *     { text: 'Opção 1', icon: <Icon1 /> },
- *     { text: 'Opção 2', icon: <Icon2 /> }
- *   ]}
- *   type="text"
- *   placeholder="Selecione uma opção"
- * />
- * ```
- * @example
- * ```tsx
- * <Dropdown
- *   items={items}
- *   type="checkbox"
- *   applySearch={true}
- *   onSelectionChange={(ids) => console.log(ids)}
- *   defaultSelectedIds={['1', '2']}
- *   maxHeight="300px"
- * />
- * ```
- */
-interface DropdownProps extends BaseProps {
-    /** Força posição do dropdown: 'top' abre para cima, 'bottom' para baixo (detecção automática se não especificado) */
-    position?: 'top' | 'bottom';
-    /** Array de itens para o dropdown */
-    items: DropdownItem[];
-    /** Tipo do dropdown */
-    type?: DropdownType;
-    /** Habilita campo de busca */
-    applySearch?: boolean;
-    /** Placeholder do campo de busca */
-    placeholder?: string;
-    /** Callback executado quando a seleção muda: (selectedIds) => void */
-    onSelectionChange?: (selectedIds: string[]) => void;
-    /** Controla exibição do subtexto dos itens */
-    showSubText?: boolean;
-    /** IDs dos itens selecionados por padrão */
-    defaultSelectedIds?: string[];
-    /** Estado inicial dos itens selecionados (objeto chave-valor) */
-    initialItemsSelected?: Record<string, boolean>;
-    /** Largura do dropdown */
-    width?: string | number;
-    /** Largura máxima do dropdown */
-    maxWidth?: string | number;
-    /** Largura mínima do dropdown */
-    minWidth?: string | number;
-    /** Altura máxima do dropdown */
-    maxHeight?: string | number;
-    /** Define se o componente está sendo usado para filtro */
-    filter?: boolean;
-    /** Configurações para paginação infinita */
-    infiniteScroll?: {
-        /** Status atual do carregamento */
-        status: 'idle' | 'loading' | 'succeeded' | 'failed';
-        /** Página atual */
-        page: number;
-        /** Última página disponível */
-        lastPage: number;
-        /** Callback executado para carregar próxima página: () => void */
-        onLoadMore: () => void;
-        /** Threshold para trigger do scroll infinito (0-1) */
-        threshold?: number;
-        /** Margem para trigger do scroll infinito */
-        rootMargin?: string;
-        /** Modo de debug */
-        debug?: boolean;
-    };
-}
-
-declare const MemoizedDropdown: React__default.NamedExoticComponent<DropdownProps>;
-
-/**
- * Props do componente Filter
- * @example
- * ```tsx
- * <Filter
- *   items={filterItems}
- *   type="checkbox"
- *   placeholder="Filtrar por categoria"
- *   onApplyFilter={(ids) => handleFilter(ids)}
- *   buttonText="Filtros"
- * />
- * ```
- * @example
- * ```tsx
- * <Filter
- *   type="calendar"
- *   selectedDate={selectedDate}
- *   onDateSelect={handleDateSelect}
- *   minDate={new Date('2024-01-01')}
- *   locale="pt-br"
- *   icon={<CalendarIcon />}
- * />
- * ```
- */
-interface FilterProps extends BaseProps {
-    /** Array de itens para filtros do tipo dropdown */
-    items?: DropdownItem[];
-    /** Tipo do filtro (dropdown ou calendário) */
-    type?: DropdownType | 'calendar';
-    /** IDs dos itens selecionados */
-    selectedIds?: string[];
-    /** Callback executado ao aplicar filtro: (selectedIds) => void */
-    onApplyFilter?: (selectedIds: string[]) => void;
-    /** Placeholder do campo de busca */
-    placeholder?: string;
-    /** Habilita campo de busca no dropdown */
-    enableSearch?: boolean;
-    /** Texto ou conteúdo do botão de filtro */
-    buttonText?: string | ReactNode;
-    /** Ícone do botão de filtro */
-    icon?: ReactElement;
-    /** Variante visual do botão */
-    variant?: Variant;
-    /** Callback executado ao abrir o filtro: () => void */
-    onOpen?: () => void;
-    /** Callback executado ao fechar o filtro: () => void */
-    onClose?: () => void;
-    /** Posição do dropdown em relação ao botão */
-    position?: Position;
-    /** Data selecionada (para tipo calendar) */
-    selectedDate?: Date | null;
-    /** Callback executado ao selecionar data: (date) => void */
-    onDateSelect?: (date: Date) => void;
-    /** Callback executado ao limpar data: () => void */
-    onClearDate?: () => void;
-    /** Data mínima selecionável (para tipo calendar) */
-    minDate?: Date;
-    /** Data máxima selecionável (para tipo calendar) */
-    maxDate?: Date;
-    /** Locale do calendário */
-    locale?: Locale;
-}
-
-declare const Filter: React__default.FC<FilterProps>;
-
-/** Variantes disponíveis para o ListItem */
-type ListItemVariant = 'text' | 'checkbox' | 'radio' | 'icon';
-/**
- * Props do componente ListItem
- * @example
- * ```tsx
- * <ListItem
- *   variant="text"
- *   text="Item da lista"
- *   subText="Descrição do item"
- *   onClick={handleClick}
- * />
- * ```
- * @example
- * ```tsx
- * <ListItem
- *   variant="checkbox"
- *   text="Aceitar termos"
- *   checked={isChecked}
- *   onChange={setIsChecked}
- *   disabled={false}
- * />
- * ```
- */
-interface ListItemProps extends BaseProps {
-    /** Variante do item da lista */
-    variant?: ListItemVariant;
-    /** Texto principal do item */
-    text?: string;
-    /** Nome do input (para variantes checkbox/radio) */
-    name?: string;
-    /** Texto secundário/descrição do item */
-    subText?: string;
-    /** Estado de checked (para variantes checkbox/radio) */
-    checked?: boolean;
-    /** Estado de selecionado (para variantes text/icon) */
-    selected?: boolean;
-    /** Callback executado ao clicar no item: (event) => void */
-    onClick?: (event: React$1.MouseEvent<HTMLElement> | React$1.KeyboardEvent<HTMLElement>) => void;
-    /** Callback executado quando o estado muda: (checked) => void */
-    onChange?: (checked: boolean) => void;
-    /** Ícone do item (para variante icon) */
-    icon?: React$1.ReactNode;
-    /** Valor do input (para variantes checkbox/radio) */
-    value?: string;
-    /** Define se deve mostrar o subtexto */
-    showSubText?: boolean;
-    /** Estado de hover */
-    hovered?: boolean;
-}
-
-declare const ListItem: React__default.FC<ListItemProps>;
-
-/**
- * Representa um item do menu (suporta subitens aninhados)
- */
-interface MenuItemProps {
-    /** ID único do item */
-    id?: string;
-    /** Texto principal do item */
-    text?: string;
-    /** Texto secundário/descrição do item */
-    subText?: string;
-    /** Estado desabilitado do item */
-    disabled?: boolean;
-    /** Ícone do item */
-    icon?: React$1.ReactNode;
-    /** Subitens do menu (para menus aninhados) */
-    children?: MenuItemProps[];
-    /** Valor do item */
-    value?: string;
-}
-/**
- * Props do componente Menu
- * @example
- * ```tsx
- * <Menu
- *   items={[
- *     { id: '1', text: 'Perfil', icon: <UserIcon /> },
- *     { id: '2', text: 'Configurações', icon: <SettingsIcon /> }
- *   ]}
- *   onItemSelect={(item) => handleSelect(item)}
- * >
- *   <Button>Menu</Button>
- * </Menu>
- * ```
- * @example
- * ```tsx
- * <Menu
- *   items={menuItems}
- *   type="icon"
- *   search={true}
- *   enableInfiniteScroll={true}
- *   onScrollEnd={loadMore}
- *   maxHeight="400px"
- *   align="end"
- * />
- * ```
- */
-interface MenuProps extends BaseProps {
-    /** Array de itens do menu */
-    items: MenuItemProps[];
-    /** Elemento trigger customizado para abrir o menu */
-    children?: ReactElement;
-    /** Tipo de visualização do menu */
-    type?: 'text' | 'icon';
-    /** Callback executado quando um item é selecionado: (item) => void */
-    onItemSelect?: (items: MenuItemProps) => void;
-    /** Array de itens selecionados */
-    selectedItems?: MenuItemProps[];
-    /** Habilita campo de busca */
-    search?: boolean;
-    /** Alinhamento do menu */
-    align?: 'start' | 'end' | 'center';
-    /** Altura máxima do menu */
-    maxHeight?: number | string;
-    /** Habilita scroll infinito */
-    enableInfiniteScroll?: boolean;
-    /** Callback executado ao chegar ao final do scroll: () => void */
-    onScrollEnd?: () => void;
-    /** Estado de carregamento de mais itens */
-    isLoadingMore?: boolean;
-    /** Habilita busca via API */
-    enableApiSearch?: boolean;
-    /** Callback executado na busca via API: (searchTerm) => void */
-    onApiSearch?: (searchTerm: string) => void;
-    /** Callback executado quando o menu abre/fecha: (open) => void */
-    onOpenChange?: (open: boolean) => void;
-}
-
-declare const Menu: React__default.FC<MenuProps>;
-
-/**
- * Props do componente Quantity
- * @example
- * ```tsx
- * <Quantity
- *   value={quantity}
- *   onChange={setQuantity}
- *   size="lg"
- * />
- * ```
- * @example
- * ```tsx
- * <Quantity
- *   defaultValue={1}
- *   decimal={true}
- *   decimalPlaces={2}
- *   step={0.5}
- *   disabled={false}
- * />
- * ```
- */
-interface QuantityProps extends BaseProps {
-    /** Valor inicial (modo não controlado) */
-    defaultValue?: number;
-    /** Valor atual (modo controlado) */
-    value?: number;
-    /** Callback executado quando o valor muda: (value) => void */
-    onChange?: (value: number) => void;
-    /** Habilita entrada de valores decimais */
-    decimal?: boolean;
-    /** Tamanho do componente */
-    size?: Size;
-    /** Número de casas decimais permitidas */
-    decimalPlaces?: number;
-    /** Incremento/decremento ao clicar nos botões */
-    step?: number;
-}
-
-declare const memorizedQuantity: React__default.NamedExoticComponent<QuantityProps>;
-
-/**
- * Props de um item individual de rádio
- */
-interface RadioProps {
-    /** ID único do elemento */
-    id?: string | number;
-    /** Valor do radio button */
-    value: string;
-    /** Label exibida ao lado do radio button */
-    label: string;
-    /** Estado desabilitado do item */
-    disabled?: boolean;
-}
-/**
- * Props do componente RadioGroup
- * @example
- * ```tsx
- * <RadioGroup
- *   items={[
- *     { value: 'option1', label: 'Opção 1' },
- *     { value: 'option2', label: 'Opção 2' }
- *   ]}
- *   onValueChange={(value) => setSelected(value)}
- *   defaultValue="option1"
- * />
- * ```
- * @example
- * ```tsx
- * <RadioGroup
- *   items={options}
- *   onValueChange={handleChange}
- *   name="preference"
- *   orientation="horizontal"
- *   ariaLabel="Selecione sua preferência"
- * />
- * ```
- */
-interface RadioGroupProps extends BaseProps {
-    /** Array de itens de rádio */
-    items: RadioProps[];
-    /** Callback executado quando o valor muda: (value) => void */
-    onValueChange?: (value: string) => void;
-    /** Valor inicial selecionado */
-    defaultValue?: string;
-    /** Nome do grupo de radio buttons */
-    name?: string;
-    /** Label acessível para leitores de tela */
-    ariaLabel?: string;
-    /** Orientação do layout dos radio buttons */
-    orientation?: "horizontal" | "vertical";
-}
-
-declare const Radio: React__default.FC<RadioGroupProps>;
-
-/**
- * Props do componente Search
- * @example
- * ```tsx
- * <Search
- *   placeholder="Buscar..."
- *   value={searchTerm}
- *   onChange={(e) => setSearchTerm(e.target.value)}
- *   onClear={() => setSearchTerm('')}
- * />
- * ```
- * @example
- * ```tsx
- * <Search
- *   placeholder="Pesquisar produtos"
- *   disabled={isLoading}
- *   onKeyDown={(e) => e.key === 'Enter' && handleSearch()}
- *   onFocus={handleFocus}
- * />
- * ```
- */
-interface SearchProps extends BaseProps {
-    /** Placeholder do campo de busca */
-    placeholder?: string;
-    /** Valor controlado do campo */
-    value?: string;
-    /** Callback executado quando o valor muda: (e) => void */
-    onChange?: (e: React$1.ChangeEvent<HTMLInputElement>) => void;
-    /** Callback executado ao pressionar tecla: (e) => void */
-    onKeyDown?: (e: React$1.KeyboardEvent<HTMLInputElement>) => void;
-    /** Callback executado ao focar no campo: (e) => void */
-    onFocus?: (e: React$1.FocusEvent<HTMLInputElement>) => void;
-    /** Callback executado ao desfocar do campo: (e) => void */
-    onBlur?: (e: React$1.FocusEvent<HTMLInputElement>) => void;
-    /** Callback executado ao limpar o campo: () => void */
-    onClear?: () => void;
-    /** Callback executado ao clicar no componente: (e) => void */
-    onClick?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
-    /** Callback executado ao pressionar mouse no componente: (e) => void */
-    onMouseDown?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
-    /** ID para testes automatizados */
-    'data-testid'?: string;
-}
-
-declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
-
-/**
- * Representa um item do select
- */
-interface SelectItemProps extends BaseProps {
-    /** Texto principal do item */
-    text: ReactNode;
-    /** Subtítulo ou descrição do item */
-    subTitle?: ReactNode;
-    /** Ícone do item */
-    icon?: ReactNode;
-    /** Valor do item */
-    value: string;
-    /** Define se o item está selecionado */
-    selected?: boolean;
-    /** Subitens do select (para selects aninhados) */
-    children?: SelectItemProps[];
-}
-/** Variantes disponíveis para o Select */
-type SelectVariant = 'text' | 'icon' | 'checkbox';
-/**
- * Props do componente Select
- * @example
- * ```tsx
- * <Select
- *   items={[
- *     { value: '1', text: 'Opção 1' },
- *     { value: '2', text: 'Opção 2' }
- *   ]}
- *   variant="text"
- *   placeholder="Selecione uma opção"
- *   onValueChange={(value) => console.log(value)}
- * />
- * ```
- * @example
- * ```tsx
- * <Select
- *   items={options}
- *   variant="checkbox"
- *   multiple={true}
- *   search={true}
- *   label="Selecione múltiplas opções"
- *   helperText="Você pode selecionar mais de uma"
- *   required={true}
- * />
- * ```
- */
-interface SelectProps extends BaseProps {
-    /** Array de itens do select */
-    items: SelectItemProps[];
-    /** Callback executado quando o valor muda: (value) => void */
-    onValueChange?: (value: string | string[]) => void;
-    /** Callback executado quando o select abre/fecha: (open) => void */
-    onOpenChange?: (open: boolean) => void;
-    /** Variante visual do select */
-    variant: SelectVariant;
-    /** Define se o campo é obrigatório */
-    required?: boolean;
-    /** Valor(es) selecionado(s) */
-    value?: string | string[];
-    /** Habilita seleção múltipla */
-    multiple?: boolean;
-    /** Placeholder do campo */
-    placeholder?: string;
-    /** Habilita campo de busca */
-    search?: boolean;
-    /** Label do campo */
-    label?: string;
-    /** Texto de ajuda exibido abaixo do campo */
-    helperText?: string;
-    /** Largura máxima do select */
-    maxWidth?: number;
-    /** Mensagem de erro a ser exibida */
-    errorMessage?: string;
-    /** Label acessível para leitores de tela */
-    'aria-label'?: string;
-    /** ID para testes automatizados */
-    'data-testid'?: string;
-    /** Habilita tooltip */
-    tooltip?: boolean;
-    /** Texto do tooltip */
-    tooltipText?: string;
-    /** Lado onde o dropdown abre */
-    side?: Side;
-    /** Alinhamento do dropdown */
-    align?: Align;
-    /** Habilita scroll infinito */
-    enableInfiniteScroll?: boolean;
-    /** Callback executado ao chegar ao final do scroll: () => void */
-    onScrollEnd?: () => void;
-    /** Estado de carregamento de mais itens */
-    isLoadingMore?: boolean;
-    /** Habilita busca via API */
-    enableApiSearch?: boolean;
-    /** Callback executado na busca via API: (term) => void */
-    onApiSearch?: (term: string) => void;
-    /** Estado de busca em andamento */
-    isSearching?: boolean;
-}
-
-declare const Select: React__default.FC<SelectProps>;
-
-/**
- * Tipo base para dados da tabela. Use `<Table<SeuTipo>>` para type-safety completo.
- * @example <Table<User> dataSource={users} />
- */
-type TableRowData = Record<string, any>;
-/** Tipos de coluna suportados */
-type TableColumnType = 'text' | 'datetime' | 'custom';
-/** Opções de alinhamento de coluna */
-type TableAlign = 'left' | 'center' | 'right';
-/**
- * Configuração de coluna da tabela
- * @typeParam T - Tipo dos dados da linha
- */
-interface TableColumn<T = TableRowData> {
-    /** Chave única identificadora da coluna */
-    key: string;
-    /** Conteúdo do cabeçalho da coluna */
-    label: ReactNode;
-    /** Tipo de dados da coluna */
-    type?: TableColumnType;
-    /** Formato de exibição (ex: 'dd/MM/yyyy' para datetime) */
-    format?: string;
-    /** Função customizada para renderizar o conteúdo da célula */
-    render?: (row: T, index: number) => ReactNode;
-    /** Alinhamento do conteúdo */
-    align?: TableAlign;
-    /** Estilos CSS customizados */
-    style?: CSSProperties;
-}
-/**
- * Props do componente Table. Use genérico para autocomplete: `<Table<User>>`
- * @typeParam T - Tipo dos dados da linha
- */
-interface TableProps<T = TableRowData> extends BaseProps {
-    /** Configuração das colunas */
-    columns: TableColumn<T>[];
-    /** Array de dados a serem exibidos */
-    dataSource: T[];
-    /** Estado de carregamento */
-    loading?: boolean;
-    /** Configuração de seleção de linhas */
-    rowSelection?: {
-        /** Keys das linhas selecionadas (modo controlado) */
-        selectedRowKeys?: (string | number)[];
-        /** Callback quando seleção muda: (keys, rows) => void */
-        onChange?: (keys: (string | number)[], rows: T[]) => void;
-        /** Customiza props dos checkboxes: (row, index) => { disabled? } */
-        getCheckboxProps?: (row: T, index: number) => {
-            disabled?: boolean;
-        };
-        /** Desabilita o checkbox "selecionar todos" */
-        disableSelectAll?: boolean;
-    };
-    /** Configurações de localização */
-    locale?: {
-        /** Texto quando não há dados */
-        emptyText?: ReactNode;
-    };
-    /** Eventos de linha: (row, index) => { onClick?, onDoubleClick?, className? } */
-    onRow?: (row: T, index: number) => {
-        /** Clique simples na linha */
-        onClick?: () => void;
-        /** Clique duplo na linha */
-        onDoubleClick?: () => void;
-        /** Classe CSS da linha */
-        className?: string;
-    };
-}
-
-declare const Table: <T extends TableRowData = TableRowData>({ columns, dataSource, className, loading, rowSelection, locale, onRow, ...rest }: TableProps<T>) => react_jsx_runtime.JSX.Element | null;
-
-interface BaseFilterItem {
-    id?: string;
-    buttonText: string | React__default.ReactNode;
-    icon?: React__default.ReactElement;
-    position?: 'left' | 'right';
-    disabled?: boolean;
-    onToggle?: (isOpen: boolean) => void;
-    tooltip?: string;
-}
-interface CheckboxFilterItem extends BaseFilterItem {
-    type: 'checkbox' | 'text' | 'icon';
-    items: DropdownItem[];
-    selectedIds?: string[];
-    onSelectionChange?: (selectedIds: string[]) => void;
-    placeholder?: string;
-    enableSearch?: boolean;
-}
-interface CalendarFilterItem extends BaseFilterItem {
-    type: 'calendar';
-    selectedDate?: Date | null;
-    onDateSelect?: (date: Date) => void;
-    onClear?: () => void;
-    minDate?: Date;
-    maxDate?: Date;
-    locale?: string;
-    placeholder?: string;
-}
-type FilterItem = CheckboxFilterItem | CalendarFilterItem;
-interface TableHeaderProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    searchValue?: string;
-    onSearchChange?: (value: string) => void;
-    searchPlaceholder?: string;
-    showSearch?: boolean;
-    showFilters?: boolean;
-    filters?: React__default.ReactNode;
-    filterItems?: FilterItem[];
-    className?: string;
-    onSearch?: (value: string) => void;
-    showClearSearch?: boolean;
-}
-declare const TableHeader: React__default.FC<TableHeaderProps>;
-
-interface TablePaginationProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    currentPage: number;
-    totalItems: number;
-    itemsPerPage: number;
-    onPageChange: (page: number) => void;
-    onItemsPerPageChange: (itemsPerPage: number) => void;
-    pageSizeOptions?: number[];
-    disabled?: boolean;
-    className?: string;
-}
-declare const TablePagination: React__default.FC<TablePaginationProps>;
-
-/** Tipos de input suportados pelo TextField */
-type TextFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
-/**
- * Props do componente TextField
- * @example
- * ```tsx
- * <TextField
- *   label="Email"
- *   type="email"
- *   value={email}
- *   onChange={setEmail}
- *   placeholder="Digite seu email"
- * />
- * ```
- * @example
- * ```tsx
- * <TextField
- *   label="Senha"
- *   type="password"
- *   required
- *   helperText="Mínimo 8 caracteres"
- *   errorMessage={error}
- *   tooltip={true}
- *   tooltipText="Deve conter letras e números"
- *   icon={<LockIcon />}
- * />
- * ```
- */
-interface TextFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'type'> {
-    /** Valor controlado do campo */
-    value?: string | number;
-    /** Callback executado quando o valor muda: (value) => void */
-    onChange?: (value: string) => void;
-    /** Label do campo */
-    label?: string;
-    /** Tipo do input */
-    type?: TextFieldType;
-    /** Texto de ajuda exibido abaixo do campo */
-    helperText?: string;
-    /** Habilita tooltip */
-    tooltip?: boolean;
-    /** Texto do tooltip */
-    tooltipText?: string;
-    /** Lado onde o tooltip aparece */
-    side?: Side;
-    /** Alinhamento do tooltip */
-    align?: Align;
-    /** Mensagem de erro a ser exibida */
-    errorMessage?: string;
-    /** Ícone a ser exibido no campo */
-    icon?: React__default.ReactNode;
-}
-
-declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
-
-/** Tipos de toast disponíveis */
-type ToastType = 'success' | 'alert' | 'info';
-/**
- * Representa uma mensagem de toast
- */
-interface ToastMessage {
-    /** ID único da mensagem */
-    id: string;
-    /** Conteúdo da mensagem */
-    message: string;
-    /** Tipo visual do toast */
-    type: ToastType;
-    /** Define se o toast permanece até ser fechado manualmente */
-    persistent?: boolean;
-    /** Duração em milissegundos antes de auto-fechar */
-    duration?: number;
-    /** Timestamp de quando foi criado */
-    timestamp: number;
-}
-/**
- * Opções para exibição do toast
- */
-interface ToastOptions {
-    /** Define se o toast permanece até ser fechado manualmente */
-    persistent?: boolean;
-    /** Duração em milissegundos antes de auto-fechar */
-    duration?: number;
-}
-/**
- * Contexto do sistema de toasts
- * @example
- * ```tsx
- * const { showToast, hideToast } = useToast();
- *
- * showToast('Operação realizada com sucesso!', 'success');
- * ```
- */
-interface ToastContextType {
-    /** Exibe um toast e retorna seu ID: (message, type?, options?) => string */
-    showToast: (message: string, type?: ToastType, options?: ToastOptions) => string;
-    /** Oculta um toast específico: (id) => void */
-    hideToast: (id: string) => void;
-    /** Oculta todos os toasts: () => void */
-    hideAllToasts: () => void;
-}
-
-interface ToastProviderProps {
-    children: ReactNode;
-    maxToasts?: number;
-}
-declare const ToastProvider: React__default.FC<ToastProviderProps>;
-declare const useToast: () => ToastContextType;
-
-/**
- * Props do componente Tooltip
- * @example
- * ```tsx
- * <Tooltip text="Informação adicional">
- *   <Button>Hover me</Button>
- * </Tooltip>
- * ```
- * @example
- * ```tsx
- * <Tooltip
- *   text="Clique para mais detalhes"
- *   side="top"
- *   align="center"
- *   sideOffset={10}
- *   maxWidth={300}
- * >
- *   <IconButton icon={<InfoIcon />} />
- * </Tooltip>
- * ```
- */
-interface TooltipProps extends BaseProps {
-    /** Conteúdo do tooltip */
-    text: React__default.ReactNode;
-    /** Lado onde o tooltip aparece em relação ao elemento */
-    side?: Side;
-    /** Alinhamento do tooltip */
-    align?: Align;
-    /** Distância em pixels do lado do elemento */
-    sideOffset?: number;
-    /** Deslocamento em pixels no eixo de alinhamento */
-    alignOffset?: number;
-    /** Largura máxima do tooltip em pixels */
-    maxWidth?: number;
-    /** Elemento que dispara o tooltip ao hover */
-    children: React__default.ReactNode;
-}
-
-declare const Tooltip: React__default.FC<TooltipProps>;
-
-/**
- * Props do componente Switch
- * @example
- * ```tsx
- * <Switch
- *   checked={isEnabled}
- *   onCheckedChange={setIsEnabled}
- * />
- * ```
- * @example
- * ```tsx
- * <Switch
- *   defaultChecked={true}
- *   disabled={isLoading}
- *   onCheckedChange={(checked) => console.log(checked)}
- *   name="notifications"
- * />
- * ```
- */
-interface SwitchProps extends BaseProps {
-    /** Estado inicial (modo não controlado) */
-    defaultChecked?: boolean;
-    /** Callback executado quando o estado muda: (checked) => void */
-    onCheckedChange?: (checked: boolean) => void;
-    /** Nome do input */
-    name?: string;
-    /** Valor do input */
-    value?: string;
-    /** Estado atual (modo controlado) */
-    checked?: boolean;
-}
-
-declare const Switch: React$1.FC<SwitchProps>;
-
-/** Tipos de entrada suportados pelo VerificationCode */
-type InputType = 'numeric' | 'alpha' | 'alphanumeric';
-/**
- * Props do componente VerificationCode
- * @example
- * ```tsx
- * <VerificationCode
- *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => handleVerification(code)}
- * />
- * ```
- * @example
- * ```tsx
- * <VerificationCode
- *   length={4}
- *   inputType="alphanumeric"
- *   onComplete={handleCode}
- *   hasError={!!error}
- *   errorMessage="Código inválido"
- *   disabled={isVerifying}
- * />
- * ```
- */
-interface VerificationCodeProps extends BaseProps {
-    /** Número de dígitos do código (padrão: 6) */
-    length?: number;
-    /** Tipo de entrada permitida (padrão: "numeric") */
-    inputType?: InputType;
-    /** Callback executado quando todos os campos são preenchidos: (value) => void */
-    onComplete?: (value: string) => void;
-    /** Define se o campo está em estado de erro */
-    hasError?: boolean;
-    /** Mensagem de erro exibida abaixo do componente */
-    errorMessage?: string;
-    /** Props adicionais passadas para os inputs */
-    [key: string]: any;
-}
-
-/**
- * Componente VerificationCode para entrada de códigos de verificação
- *
- * @description Permite entrada de códigos com múltiplos dígitos,
- * suportando diferentes tipos de caracteres e navegação por teclado.
- *
- * @example
- * ```tsx
- * <VerificationCode
- *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => console.log('Código:', code)}
- *   hasError={false}
- * />
- * ```
- */
-declare const VerificationCode: React__default.FC<VerificationCodeProps>;
-
-/**
- * Configurações para simulação de API
- */
-interface ApiSimulationConfig {
-    /** Items por página */
-    itemsPerPage?: number;
-    /** Total de items no dataset */
-    totalItems?: number;
-    /** Delay em ms para simular latência */
-    delay?: number;
-    /** Taxa de erro (0-1) para simular falhas */
-    errorRate?: number;
-    /** Função geradora de items customizada */
-    itemGenerator?: (index: number, searchQuery?: string) => any;
-    /** Debug mode */
-    debug?: boolean;
-}
-/**
- * Estado da simulação de API
- */
-interface ApiSimulationState<T> {
-    /** Items carregados */
-    items: T[];
-    /** Página atual */
-    currentPage: number;
-    /** Total de páginas */
-    totalPages: number;
-    /** Status do carregamento */
-    status: 'idle' | 'loading' | 'succeeded' | 'failed';
-    /** Erro atual (se houver) */
-    error: string | null;
-    /** Query de busca atual */
-    searchQuery: string;
-    /** Se há próxima página */
-    hasNextPage: boolean;
-    /** Se é a primeira página */
-    isFirstPage: boolean;
-}
-interface ApiSimulationActions {
-    /** Carregar próxima página */
-    loadNextPage: () => Promise<void>;
-    /** Realizar nova busca */
-    search: (query: string) => Promise<void>;
-    /** Reset completo */
-    reset: () => void;
-    /** Retry da última operação */
-    retry: () => Promise<void>;
-}
-interface UseApiSimulationReturn<T> extends ApiSimulationState<T> {
-    actions: ApiSimulationActions;
-}
-declare function useApiSimulation<T = any>(config?: ApiSimulationConfig): UseApiSimulationReturn<T>;
-
-/**
- * Props para o hook useInfiniteScroll
- */
-interface UseInfiniteScrollProps {
-    /** Status atual do carregamento */
-    status: 'idle' | 'loading' | 'succeeded' | 'failed';
-    /** Página atual */
-    page: number;
-    /** Última página disponível */
-    lastPage: number;
-    /** Callback para carregar próxima página */
-    onLoadMore: () => void;
-    /** Threshold para IntersectionObserver (0-1) */
-    threshold?: number;
-    /** Margem raiz para IntersectionObserver */
-    rootMargin?: string;
-    /** Habilita/desabilita o hook */
-    enabled?: boolean;
-    /** Debug mode - logs no console */
-    debug?: boolean;
-}
-/**
- * Retorno do hook useInfiniteScroll
- */
-interface UseInfiniteScrollReturn {
-    /** Ref para o elemento observador */
-    observerRef: React.RefObject<HTMLDivElement | null>;
-    /** Se o elemento está visível */
-    isIntersecting: boolean;
-    /** Se há próxima página */
-    hasNextPage: boolean;
-    /** Se todas as páginas foram carregadas */
-    isCompleted: boolean;
-    /** Função para reset manual */
-    reset: () => void;
-}
-/**
- * Hook otimizado para scroll infinito usando IntersectionObserver
- */
-declare function useInfiniteScroll({ status, page, lastPage, onLoadMore, threshold, rootMargin, enabled, debug }: UseInfiniteScrollProps): UseInfiniteScrollReturn;
-
-declare const normalizeText: (text: React.ReactNode) => string;
-
-export { Avatar, Badge, Button, MemoizedCalendar as Calendar, Callout, Checkbox, MemoizedChips as Chips, Container, _default$1 as DatePicker, MemoizedDialog as Dialog, Drawer, MemoizedDropdown as Dropdown, Filter, ListItem, Menu, memorizedQuantity as Quantity, Radio, Search, Select, Switch, Table, TableHeader, TablePagination, _default as TextField, ToastProvider as Toast, ToastProvider, Tooltip, VerificationCode, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
-export type { AvatarProps, BadgeProps, ButtonProps, CalendarItem, CalendarProps, CalloutProps, CheckboxProps, ChipsProps, ContainerProps, DateFormat, DatePickerProps, DayItem, DialogProps, DrawerProps, DropdownItem, DropdownProps, DropdownType, EmptyItem, FilterItem, FilterProps, ListItemProps, MenuProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, TextFieldProps, ToastContextType, ToastMessage, ToastOptions, ToastType, TooltipProps, VerificationCodeProps, YearItem };