@cnc-ti/layout-basic 8.5.0 → 8.7.0

package/dist/index.d.mts

@@ -306,6 +306,11 @@ interface InputProps extends React$1.ComponentProps<"input"> {
 }
 declare const Input: React$1.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
 
+interface TextareaProps extends React$1.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    label?: string;
+}
+declare const Textarea: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+
 interface CheckboxProps extends React$1.ComponentProps<"input"> {
     label?: string;
 }
@@ -347,6 +352,20 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
  */
 declare const Badge: ({ variant, rounded, size, className, ...rest }: BadgeProps) => react_jsx_runtime.JSX.Element;
 
+interface AvatarProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** URL da imagem do usuário. Se ausente ou falhar, exibe o fallback. */
+    src?: string | null;
+    /** Texto alternativo da imagem. */
+    alt?: string;
+    /** Conteúdo de fallback quando não há imagem (ex.: iniciais do nome). */
+    fallback?: React$1.ReactNode;
+    /** Tamanho do avatar. Padrão: "md". */
+    size?: "sm" | "md" | "lg" | "xl";
+    /** Indica carregamento (esqueleto pulsante). */
+    isLoading?: boolean;
+}
+declare function Avatar({ src, alt, fallback, size, isLoading, className, ...props }: AvatarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Componente principal do Card.
  * Utilizado para agrupar visualmente conteúdos relacionados.
@@ -457,27 +476,75 @@ interface TitleProps {
  */
 declare function Title({ title, as: Component }: TitleProps): react_jsx_runtime.JSX.Element;
 
+interface EmptyStateProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    icon?: React$1.ReactNode;
+    title: string;
+    description?: React$1.ReactNode;
+    action?: React$1.ReactNode;
+    minHeight?: string;
+}
+declare function EmptyState({ icon, title, description, action, minHeight, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Regra de gênero para o sufixo "encontrad(o|a)s".
+ * Se omitido, usa heurística: última letra do `resourceName` é "a" → feminina.
+ */
+type ResultMetadataGender = "masc" | "fem";
+interface ResultMetadataProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Nome do recurso a ser exibido (ex: "Negociações", "Subgrupos"). */
+    resourceName: string;
+    /** Total de registros retornados pela API. */
+    total: number;
+    /** Quantidade de registros exibidos na tela. */
+    displayed: number;
+    /** Indica se os dados ainda estão sendo carregados (opcional). */
+    isLoading?: boolean;
+    /**
+     * Gênero forçado para "encontrado(s)" / "encontrada(s)".
+     * Use quando a heurística da última letra falha (ex.: "Sistema").
+     */
+    forceWordGender?: ResultMetadataGender;
+    /**
+     * A partir de quantos registros exibidos o aviso
+     * "Exibindo os X primeiros registros..." aparece. Padrão: 30.
+     */
+    truncationThreshold?: number;
+}
+declare function ResultMetadata({ resourceName, total, displayed, isLoading, forceWordGender, truncationThreshold, className, ...props }: ResultMetadataProps): react_jsx_runtime.JSX.Element;
+
+interface LabelValueProps {
+    /** Rótulo exibido em destaque acima do valor. */
+    label: string;
+    /** Valor exibido. Vazio ou ausente mostra "-". */
+    value?: React$1.ReactNode;
+    /** Link externo opcional exibido ao lado do valor. */
+    href?: string;
+    className?: string;
+    valueClassName?: string;
+}
+declare function LabelValue({ label, value, href, className, valueClassName, }: LabelValueProps): react_jsx_runtime.JSX.Element;
+
+interface ComboboxFooterAction {
+    /** Texto do botão (ex.: "Cadastrar Nova Temática") */
+    label: React$1.ReactNode;
+    /** App abre modal, chama API, atualiza options */
+    onClick: (event: React$1.MouseEvent<HTMLButtonElement>) => void;
+    /** Variante visual (default: create) */
+    variant?: "create" | "confirm" | "outline";
+    disabled?: boolean;
+}
+interface ComboboxFooterRenderContext {
+    close: () => void;
+}
+
 /**
  * Representa uma opção que pode ser selecionada no combobox.
- * @typedef {Object} ItemOption
- * @property {*} value - O valor associado à opção.
- * @property {string} label - O rótulo que será exibido para o usuário.
  */
 interface ItemOption {
     value: any;
     label: string;
     disabled?: boolean;
 }
-/**
- * Propriedades para o componente Combobox.
- *
- * @typedef {Object} ComboboxProps
- * @property {ItemOption[]} [options] - Lista de opções disponíveis para seleção.
- * @property {string} [placeholder] - Placeholder exibido quando nenhuma opção estiver selecionada.
- * @property {{ placeholder?: string, emptyMessage?: string }} [command] - Configurações do campo de busca da lista de opções.
- * @property {(value: string) => void} [onChange] - Função chamada quando uma opção for selecionada.
- * @property {string} [value] - Valor atualmente selecionado.
- */
 interface ComboboxProps {
     options?: ItemOption[];
     placeholder?: string;
@@ -488,36 +555,44 @@ interface ComboboxProps {
     onChange?: (value: string) => void;
     value?: string;
     onInput?: (value: string) => void;
-    /** Se o popover deve ter comportamento modal (padrão: false para compatibilidade com Drawers) */
     modal?: boolean;
-    /** Classes CSS adicionais para o PopoverContent */
     popoverClassName?: string;
-    /** Classes CSS adicionais para o botão trigger */
     buttonClassName?: string;
-    /** Desabilita o combobox */
     disabled?: boolean;
+    /** Botão fixo no rodapé do dropdown (ex.: "Cadastrar novo") */
+    footerAction?: ComboboxFooterAction;
+    /** Slot customizado no rodapé; tem precedência sobre footerAction */
+    renderFooter?: (ctx: ComboboxFooterRenderContext) => React$1.ReactNode;
 }
+declare function Combobox({ options, placeholder, command, onChange, value, onInput, modal, popoverClassName, buttonClassName, disabled, footerAction, renderFooter, }: ComboboxProps): react_jsx_runtime.JSX.Element;
+
 /**
- * Componente Combobox reutilizável com suporte a busca, exibição de placeholder e seleção de opções.
- *
- * @param {ComboboxProps} props - Propriedades do componente.
- * @returns {JSX.Element} O componente renderizado.
- *
- * @example
- * ```tsx
- * <Combobox
- *   options={[
- *     { value: 'apple', label: 'Apple' },
- *     { value: 'banana', label: 'Banana' },
- *   ]}
- *   placeholder="Selecione uma fruta"
- *   command={{ placeholder: 'Buscar...', emptyMessage: 'Nenhum resultado' }}
- *   value={selected}
- *   onChange={(newValue) => setSelected(newValue)}
- * />
- * ```
+ * Representa uma opção selecionável no MultiSelect.
  */
-declare function Combobox({ options, placeholder, command, onChange, value, onInput, modal, popoverClassName, buttonClassName, disabled, }: ComboboxProps): react_jsx_runtime.JSX.Element;
+interface MultiSelectOption<TValue extends string = string> {
+    value: TValue;
+    label: string;
+    disabled?: boolean;
+}
+interface MultiSelectProps<TValue extends string = string> {
+    options?: MultiSelectOption<TValue>[];
+    value?: TValue[];
+    onChange?: (value: TValue[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    modal?: boolean;
+    className?: string;
+    buttonClassName?: string;
+    popoverClassName?: string;
+    command?: {
+        placeholder?: string;
+        emptyMessage?: React$1.ReactNode;
+    };
+    selectedCountText?: (count: number) => string;
+    footerAction?: ComboboxFooterAction;
+    renderFooter?: (ctx: ComboboxFooterRenderContext) => React$1.ReactNode;
+}
+declare function MultiSelect<TValue extends string = string>({ options, value, onChange, placeholder, disabled, modal, className, buttonClassName, popoverClassName, command, selectedCountText, footerAction, renderFooter, }: MultiSelectProps<TValue>): react_jsx_runtime.JSX.Element;
 
 declare const Command: React$1.ForwardRefExoticComponent<Omit<{
     children?: React$1.ReactNode;
@@ -597,6 +672,49 @@ declare const CommandShortcut: {
     displayName: string;
 };
 
+interface ConfirmDialogProps {
+    /** Controla a abertura/fechamento do diálogo. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Título do diálogo (ex.: "Excluir demanda"). */
+    title: string;
+    /** Descrição/confirmação da ação (pode conter elementos em destaque). */
+    description?: React$1.ReactNode;
+    /** Rótulo da ação de confirmação. Padrão: "Confirmar". */
+    confirmLabel?: string;
+    /** Rótulo da ação de cancelamento. Padrão: "Cancelar". */
+    cancelLabel?: string;
+    /** Rótulo exibido no botão de confirmação durante o carregamento. */
+    loadingLabel?: string;
+    /**
+     * Chamado ao confirmar. Se retornar uma Promise, o botão entra em estado
+     * de carregamento até ela resolver. O fechamento fica a cargo do consumidor.
+     */
+    onConfirm?: () => void | Promise<void>;
+    /** Ícone exibido no círculo do cabeçalho. Padrão: ícone de lixeira. */
+    icon?: React$1.ReactNode;
+    /** Exibe o círculo colorido atrás do ícone. Padrão: `true`. */
+    showIconBackground?: boolean;
+    /** Alinhamento dos botões no rodapé. Padrão: `"center"`. */
+    footerAlign?: "center" | "end";
+    /** Variante do botão de confirmação. Padrão: "danger". */
+    confirmVariant?: "danger" | "confirm";
+    /** Conteúdo extra entre a descrição e o rodapé (ex.: Checkbox de confirmação). */
+    children?: React$1.ReactNode;
+    /** Controla o estado de carregamento externamente, sobrescrevendo o interno. */
+    isLoading?: boolean;
+    className?: string;
+}
+declare function ConfirmDialog({ open, onOpenChange, title, description, confirmLabel, cancelLabel, loadingLabel, onConfirm, icon, showIconBackground, footerAlign, confirmVariant, children, isLoading, className, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
+
+interface TooltipProps {
+    text: React$1.ReactNode;
+    children: React$1.ReactNode;
+    className?: string;
+    contentClassName?: string;
+}
+declare function Tooltip({ text, children, className, contentClassName, }: TooltipProps): react_jsx_runtime.JSX.Element;
+
 type FilterFieldType = "text" | "combobox" | "switch" | "date";
 type FilterValues = Record<string, string | boolean>;
 interface FilterField {
@@ -637,6 +755,255 @@ interface CardListProps<T> {
 }
 declare function CardList<T>({ items, renderCard, emptyMessage, minItemWidth, className, gap, getKey, isLoading, skeletonCount, }: CardListProps<T>): react_jsx_runtime.JSX.Element;
 
+declare const Drawer: React$1.FC<DialogPrimitive.DialogProps>;
+declare const DrawerTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const DrawerPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
+declare const DrawerClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const DrawerOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface DrawerContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
+    /** Lado da tela em que o painel desliza. Padrão: "right". */
+    side?: "left" | "right";
+    /** Largura pré-definida do painel em telas >= sm. Padrão: "md". */
+    size?: "sm" | "md" | "lg" | "xl" | "full";
+    /** Largura customizada (sobrescreve `size`). */
+    width?: string;
+    /** Exibe o botão de fechar padrão no canto superior. Padrão: true. */
+    closeButton?: boolean;
+}
+declare const DrawerContent: React$1.ForwardRefExoticComponent<DrawerContentProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DrawerHeader: {
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const DrawerBody: {
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const DrawerFooter: {
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const DrawerTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const DrawerDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
+
+/**
+ * Contexto opcional para orquestrar múltiplos `Drawer`s por id, no padrão
+ * `activeDrawer`/`openDrawer(id)` já usado nos projetos consumidores.
+ *
+ * Uso típico:
+ * ```tsx
+ * <DrawerProvider>
+ *   <MinhaPagina />
+ * </DrawerProvider>
+ *
+ * const { isOpen, openDrawer, closeDrawer } = useDrawer();
+ * <Drawer open={isOpen("detalhes")} onOpenChange={(open) => !open && closeDrawer()}>
+ *   ...
+ * </Drawer>
+ * ```
+ */
+interface DrawerContextValue {
+    activeDrawer: string | null;
+    openDrawer: (drawerId: string) => void;
+    closeDrawer: () => void;
+    isOpen: (drawerId: string) => boolean;
+}
+interface DrawerProviderProps {
+    children: React$1.ReactNode;
+}
+declare const DrawerContext: React$1.Context<DrawerContextValue | undefined>;
+declare function DrawerProvider({ children }: DrawerProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useDrawer(): DrawerContextValue;
+
+type FileRejectionReason = "type" | "size" | "duplicate";
+interface FileRejection {
+    file: File;
+    reason: FileRejectionReason;
+    /** Mensagem pronta para ser exibida pelo consumidor. */
+    message: string;
+}
+interface ValidateFilesOptions {
+    currentFiles?: File[];
+    incomingFiles: File[];
+    allowedTypes?: string[];
+    maxSize?: number;
+    multiple?: boolean;
+}
+/** Formata bytes em KB ou MB usando localidade pt-BR. */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Valida um lote de arquivos e separa itens aceitos de itens recusados.
+ */
+declare function validateFiles({ currentFiles, incomingFiles, allowedTypes, maxSize, multiple, }: ValidateFilesOptions): {
+    acceptedFiles: File[];
+    rejectedFiles: FileRejection[];
+};
+
+interface FileUploadProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Arquivos atualmente selecionados. */
+    value?: File[];
+    onChange?: (files: File[]) => void;
+    /** Permite selecionar mais de um arquivo. Padrão: true. */
+    multiple?: boolean;
+    /** Valor repassado ao input nativo. */
+    accept?: string;
+    /** Lista de MIME types aceitos para validação em JavaScript. */
+    allowedTypes?: string[];
+    /** Tamanho máximo por arquivo, em bytes. */
+    maxSize?: number;
+    disabled?: boolean;
+    /** Indica que uma operação externa está em andamento. */
+    isLoading?: boolean;
+    /** Rótulo exibido no botão de seleção. */
+    buttonLabel?: string;
+    /** Texto de apoio abaixo do botão. */
+    hint?: React$1.ReactNode;
+    /** Ícone exibido no botão. */
+    icon?: React$1.ReactNode;
+    /** Chamado quando um ou mais arquivos são rejeitados. */
+    onReject?: (rejections: FileRejection[]) => void;
+    /** Exibe a lista de arquivos selecionados abaixo do botão. */
+    showList?: boolean;
+    /** Personaliza o título da lista de pendentes. */
+    listTitle?: (count: number) => React$1.ReactNode;
+    buttonClassName?: string;
+    listClassName?: string;
+}
+declare const FileUpload: React$1.ForwardRefExoticComponent<FileUploadProps & React$1.RefAttributes<HTMLInputElement>>;
+
+interface FileListItem {
+    /** Chave estável do item. */
+    id: string;
+    /** Nome do arquivo exibido para o usuário. */
+    name: string;
+    /** Tamanho em bytes, quando disponível. */
+    size?: number;
+    /** Linha secundária de metadados. */
+    meta?: React$1.ReactNode;
+    /** Descrição opcional exibida abaixo dos metadados. */
+    description?: React$1.ReactNode;
+    /** Indica que o item representa um arquivo ainda não persistido. */
+    status?: "pending" | "persisted";
+    disabled?: boolean;
+}
+interface FileListProps extends React$1.HTMLAttributes<HTMLUListElement> {
+    items: FileListItem[];
+    onRemove?: (item: FileListItem, index: number) => void;
+    onDownload?: (item: FileListItem, index: number) => void;
+    disabled?: boolean;
+    variant?: "bordered" | "plain";
+    emptyState?: React$1.ReactNode;
+    removeLabel?: string;
+}
+declare function FileList({ items, onRemove, onDownload, disabled, variant, emptyState, removeLabel, className, ...props }: FileListProps): react_jsx_runtime.JSX.Element | null;
+
+declare const MESES_PT_BR: readonly ["Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho", "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro"];
+declare const MESES_PT_BR_ABREV: readonly ["JAN", "FEV", "MAR", "ABR", "MAI", "JUN", "JUL", "AGO", "SET", "OUT", "NOV", "DEZ"];
+declare const DIAS_SEMANA_PT_BR: readonly ["DOM", "SEG", "TER", "QUA", "QUI", "SEX", "SÁB"];
+/** Formata uma Date como `yyyy-MM-dd` no horário local. */
+declare function toDateKey(date: Date): string;
+/** Normaliza uma Date para o meio-dia do dia local (evita deslocamento de fuso). */
+declare function toLocalNoon(date: Date): Date;
+declare function isSameDay(a: Date, b: Date): boolean;
+declare function isToday(date: Date): boolean;
+interface MonthDay {
+    /** Dia ao meio-dia local. */
+    date: Date;
+    number: number;
+    /** Chave `yyyy-MM-dd` do dia. */
+    dateKey: string;
+    isToday: boolean;
+    isSelected: boolean;
+    hasItems: boolean;
+}
+/**
+ * Monta a grade de dias de um mês a partir de domingo.
+ * Células `null` no início representam o deslocamento do primeiro dia da semana.
+ */
+declare function buildMonthDays(month: Date, selectedDate?: Date | null, hasItems?: (date: Date) => boolean): (MonthDay | null)[];
+/** Formata um mês como "Setembro 2026". */
+declare function formatMonthYear(date: Date): string;
+/** Rótulo completo de um dia para leitores de tela, ex.: "quinta-feira, 27 de agosto de 2026". */
+declare function formatDayAriaLabel(date: Date): string;
+
+interface MiniMonthCalendarDay extends MonthDay {
+}
+interface MiniMonthCalendarProps {
+    /** Mês exibido (controlado). Ausente ou vazio usa o mês atual. */
+    month?: Date;
+    /** Chamado ao navegar para outro mês. */
+    onMonthChange?: (month: Date) => void;
+    /** Data selecionada (controlada). */
+    selectedDate?: Date | null;
+    /** Chamado ao clicar em um dia. */
+    onSelectDate?: (date: Date) => void;
+    /** Indica se o dia tem itens — mostra um ponto indicador abaixo do número. */
+    hasItems?: (date: Date) => boolean;
+    /** Substitui o conteúdo interno de cada célula de dia. */
+    renderDay?: (day: MiniMonthCalendarDay) => React$1.ReactNode;
+    /** Cabeçalho dos dias da semana. Padrão: DOM..SÁB. */
+    weekDays?: readonly string[];
+    /** Texto do título do mês. Padrão: formatMonthYear. */
+    monthLabel?: (month: Date) => string;
+    previousLabel?: string;
+    nextLabel?: string;
+    className?: string;
+}
+declare function MiniMonthCalendar({ month: monthProp, onMonthChange, selectedDate, onSelectDate, hasItems, renderDay, weekDays, monthLabel, previousLabel, nextLabel, className, }: MiniMonthCalendarProps): react_jsx_runtime.JSX.Element;
+
+interface MonthYearPickerProps {
+    /** Mês/ano atual (controlado). */
+    value: Date;
+    onChange: (date: Date) => void;
+    disabled?: boolean;
+    /** Texto do trigger. Padrão: formatMonthYear. */
+    triggerLabel?: (value: Date) => string;
+    previousYearLabel?: string;
+    nextYearLabel?: string;
+    className?: string;
+    triggerClassName?: string;
+    contentClassName?: string;
+}
+declare function MonthYearPicker({ value, onChange, disabled, triggerLabel, previousYearLabel, nextYearLabel, className, triggerClassName, contentClassName, }: MonthYearPickerProps): react_jsx_runtime.JSX.Element;
+
+interface PeriodRange {
+    /** Identificador estável para React (gerado se ausente) */
+    id?: string;
+    start: string;
+    end: string;
+}
+type PeriodRangeInputType = "datetime-local" | "date";
+interface PeriodRangeListLabels {
+    start?: string;
+    end?: string;
+    add?: string;
+    empty?: string;
+    startColumn?: string;
+    endColumn?: string;
+    actionsColumn?: string;
+}
+interface PeriodRangeListValidateOptions {
+    endAfterStart?: boolean;
+    noDuplicates?: boolean;
+    minItems?: number;
+}
+interface PeriodRangeListProps {
+    value?: PeriodRange[];
+    onChange?: (periods: PeriodRange[]) => void;
+    inputType?: PeriodRangeInputType;
+    labels?: PeriodRangeListLabels;
+    readOnly?: boolean;
+    disabled?: boolean;
+    required?: boolean;
+    error?: string;
+    validate?: PeriodRangeListValidateOptions;
+    className?: string;
+}
+declare function PeriodRangeList({ value, onChange, inputType, labels: labelsProp, readOnly, disabled, required, error, validate, className, }: PeriodRangeListProps): react_jsx_runtime.JSX.Element;
+/** Alias explícito para formulários só com data */
+declare const DateTimeRangeList: typeof PeriodRangeList;
+
 type StatusNotificacao = "PENDENTE" | "AGENDADO" | "ENVIADO" | "PROCESSADO" | "FALHOU" | "CANCELADO" | "CONCLUIDO";
 type StatusLeitura = "NAO_LIDO" | "ENTREGUE" | "LIDO";
 /** Registro devolvido por `GET {baseUrl}/notificacoes`. */
@@ -790,6 +1157,7 @@ declare class ErroNotificacoes extends Error {
     readonly status?: number;
     constructor(mensagem: string, status?: number);
 }
+declare function normalizarBaseUrl(baseUrl: string): string;
 
 /**
  * Sino de notificações do cabeçalho: badge de não lidas, painel com a lista,
@@ -824,4 +1192,138 @@ declare class ErroNotificacoes extends Error {
  */
 declare function HeaderNotifications(props: HeaderNotificationsProps): react_jsx_runtime.JSX.Element;
 
-export { AplicationsHeader, type AppInput, type AppItem, AppsMenu, type AppsMenuProps, Badge, type BadgeSize, type BadgeVariant, Button, type ButtonProps, Card, CardContent, CardFooter, CardFooterItem, CardHeader, CardList, type CardListProps, Checkbox, type CheckboxProps, Collapsible, AnimatedCollapsibleContent as CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErroNotificacoes, Filter, type FilterField, type FilterFieldType, type FilterProps, type FilterValues, Header, HeaderContainer, type HeaderNotificationItem, HeaderNotifications, type HeaderNotificationsBaseProps, type HeaderNotificationsConectadoProps, type HeaderNotificationsControladoProps, type HeaderNotificationsProps, HeaderProfileHeader, HeaderProfileItem, type HeaderProps, Input, type InputProps, type ItemOption, Modal, ModalEntidade, ModalMudancaEntidade, type ModalProps, type Notificacao, PageHeader, PageHeaderActionsContainer, PageHeaderTitle, PageHeaderTitleContent, Popover, PopoverContent, PopoverTrigger, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectPortal, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectViewport, Sidebar, SidebarContainer, type SidebarContainerProps, SidebarImageBrand, type SidebarImageBrandProps, SidebarNavCollapse, type SidebarNavCollapseProps, SidebarNavLink, type SidebarNavLinkProps, type SidebarProps, type StatusLeitura, type StatusNotificacao, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Title, URL_PADRAO_NOTIFICACOES, availableApps, buttonVariants };
+type StatusAlerta = 'PENDENTE' | 'CONCLUIDO' | 'CANCELADO';
+interface Alerta {
+    id: string;
+    titulo: string;
+    dataReferencia: string;
+    lembrarNoDia?: boolean;
+    diasAntes: number;
+    alertasDiasAntes?: number[];
+    dataAlerta: string;
+    mensagem?: string;
+    status: StatusAlerta;
+    enviarEmail?: boolean;
+    criadoEm: string;
+    criadoPor?: {
+        nome: string;
+        email: string;
+    };
+    concluidoEm?: string;
+    canceladoEm?: string;
+    motivoCancelamento?: string;
+}
+interface CriarAlertaInput {
+    titulo: string;
+    dataReferencia: string;
+    lembrarNoDia?: boolean;
+    diasAntes?: number;
+    alertasDiasAntes?: number[];
+    mensagem?: string;
+    enviarEmail?: boolean;
+}
+type AtualizarAlertaInput = CriarAlertaInput;
+interface AlertaFormValues {
+    titulo: string;
+    dataReferencia: string;
+    lembrarNoDia: boolean;
+    diasAntes: string;
+    alertasDiasAntes: string[];
+    novoAlertaDiasAntes: string;
+    mensagem: string;
+    enviarEmail: boolean;
+}
+
+interface AlertasProps {
+    alertas?: Alerta[];
+    isLoading?: boolean;
+    isSaving?: boolean;
+    isRemovendo?: boolean;
+    podeCriar?: boolean;
+    /**
+     * Criar/editar/concluir/excluir são sempre responsabilidade do projeto que usa
+     * a lib — ela nunca faz essas requisições sozinha. Implemente aqui a chamada
+     * ao backend do próprio projeto (que por sua vez fala com a API de
+     * notificações). Pode ser assíncrono: a lib aguarda antes de fechar o
+     * formulário e atualizar a lista.
+     */
+    onCriar?: (payload: CriarAlertaInput) => void | Promise<void>;
+    onAtualizar?: (alertaId: string, payload: AtualizarAlertaInput) => void | Promise<void>;
+    onConcluir?: (alertaId: string) => void | Promise<void>;
+    onExcluir?: (alerta: Alerta) => void | Promise<void>;
+    /** E-mail do destinatário. Vira `?email=` no GET da lista de alertas. */
+    email?: string;
+    /** Identificador do sistema chamador, ex.: "gestao-eventos". */
+    sistema?: string;
+    /**
+     * Raiz da API já versionada, ex.: `https://.../v1`. Quando omitida, usa
+     * `URL_PADRAO_NOTIFICACOES`, que aponta para o **ambiente de
+     * desenvolvimento** — em produção passe explicitamente.
+     */
+    baseUrl?: string;
+    fetchFn?: typeof fetch;
+    eventoId?: number | string;
+    /** Falha ao buscar a lista (GET) ou ao salvar/concluir/excluir (erro relançado por onCriar/onAtualizar/onConcluir/onExcluir). */
+    onErro?: (erro: Error) => void;
+}
+declare function Alertas({ alertas: alertasProps, isLoading, isSaving, isRemovendo, podeCriar, onCriar, onAtualizar, onConcluir, onExcluir, baseUrl, sistema, email, fetchFn, eventoId, onErro, }: AlertasProps): react_jsx_runtime.JSX.Element;
+
+interface FormularioAlertaProps {
+    alertaEmEdicao?: Alerta | null;
+    isSaving?: boolean;
+    onSalvar: (payload: CriarAlertaInput | AtualizarAlertaInput) => void;
+    onCancelar: () => void;
+}
+declare function FormularioAlerta({ alertaEmEdicao, isSaving, onSalvar, onCancelar, }: FormularioAlertaProps): react_jsx_runtime.JSX.Element;
+
+interface AlertaItemProps {
+    alerta: Alerta;
+    disabled?: boolean;
+    selecionado?: boolean;
+    onEditar: () => void;
+    onConcluir: () => void;
+    onExcluir: () => void;
+}
+declare function AlertaItem({ alerta, disabled, selecionado, onEditar, onConcluir, onExcluir, }: AlertaItemProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Só a leitura (listagem) fala com a API de notificações direto do browser.
+ * Criar, editar, concluir e excluir são sempre responsabilidade do backend do
+ * projeto que usa a lib — não existe função de mutação aqui de propósito.
+ */
+declare class ErroAlertas extends Error {
+    readonly status?: number;
+    constructor(mensagem: string, status?: number);
+}
+interface ParametrosBuscaAlertas {
+    baseUrl: string;
+    sistema: string;
+    email: string;
+    eventoId?: number | string;
+    fetchFn?: typeof fetch;
+    signal?: AbortSignal;
+}
+declare function buscarAlertas({ baseUrl, sistema, email, fetchFn, signal, eventoId, }: ParametrosBuscaAlertas): Promise<Alerta[]>;
+
+/**
+ * Só busca a lista de alertas (GET), direto na API de notificações. Criar,
+ * editar, concluir e excluir são sempre responsabilidade do projeto que usa a
+ * lib — ver `onCriar`/`onAtualizar`/`onConcluir`/`onExcluir` em `Alertas`.
+ */
+interface OpcoesUsarAlertas {
+    baseUrl?: string;
+    sistema?: string;
+    email?: string;
+    fetchFn?: typeof fetch;
+    eventoId?: number | string;
+    habilitado?: boolean;
+    onErro?: (erro: Error) => void;
+}
+interface RetornoUsarAlertas {
+    alertas: Alerta[];
+    carregando: boolean;
+    atualizar: () => void;
+}
+declare function usarAlertas({ baseUrl, sistema, email, fetchFn, eventoId, habilitado, onErro, }: OpcoesUsarAlertas): RetornoUsarAlertas;
+
+export { type Alerta, type AlertaFormValues, AlertaItem, type AlertaItemProps, Alertas, type AlertasProps, AplicationsHeader, type AppInput, type AppItem, AppsMenu, type AppsMenuProps, type AtualizarAlertaInput, Avatar, type AvatarProps, Badge, type BadgeSize, type BadgeVariant, Button, type ButtonProps, Card, CardContent, CardFooter, CardFooterItem, CardHeader, CardList, type CardListProps, Checkbox, type CheckboxProps, Collapsible, AnimatedCollapsibleContent as CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxFooterAction, type ComboboxFooterRenderContext, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, type ConfirmDialogProps, type CriarAlertaInput, DIAS_SEMANA_PT_BR, DateTimeRangeList, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, type DrawerContentProps, DrawerContext, type DrawerContextValue, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerProvider, type DrawerProviderProps, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErroAlertas, ErroNotificacoes, FileList, type FileListItem, type FileListProps, type FileRejection, type FileRejectionReason, FileUpload, type FileUploadProps, Filter, type FilterField, type FilterFieldType, type FilterProps, type FilterValues, FormularioAlerta, type FormularioAlertaProps, Header, HeaderContainer, type HeaderNotificationItem, HeaderNotifications, type HeaderNotificationsBaseProps, type HeaderNotificationsConectadoProps, type HeaderNotificationsControladoProps, type HeaderNotificationsProps, HeaderProfileHeader, HeaderProfileItem, type HeaderProps, Input, type InputProps, type ItemOption, LabelValue, type LabelValueProps, MESES_PT_BR, MESES_PT_BR_ABREV, MiniMonthCalendar, type MiniMonthCalendarDay, type MiniMonthCalendarProps, Modal, ModalEntidade, ModalMudancaEntidade, type ModalProps, type MonthDay, MonthYearPicker, type MonthYearPickerProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, type Notificacao, type OpcoesUsarAlertas, PageHeader, PageHeaderActionsContainer, PageHeaderTitle, PageHeaderTitleContent, type ParametrosBuscaAlertas, type PeriodRange, type PeriodRangeInputType, PeriodRangeList, type PeriodRangeListLabels, type PeriodRangeListProps, type PeriodRangeListValidateOptions, Popover, PopoverContent, PopoverTrigger, ResultMetadata, type ResultMetadataGender, type ResultMetadataProps, type RetornoUsarAlertas, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectPortal, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectViewport, Sidebar, SidebarContainer, type SidebarContainerProps, SidebarImageBrand, type SidebarImageBrandProps, SidebarNavCollapse, type SidebarNavCollapseProps, SidebarNavLink, type SidebarNavLinkProps, type SidebarProps, type StatusAlerta, type StatusLeitura, type StatusNotificacao, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Title, Tooltip, type TooltipProps, URL_PADRAO_NOTIFICACOES, type ValidateFilesOptions, availableApps, buildMonthDays, buscarAlertas, buttonVariants, formatDayAriaLabel, formatFileSize, formatMonthYear, isSameDay, isToday, normalizarBaseUrl, toDateKey, toLocalNoon, usarAlertas, useDrawer, validateFiles };