@cnc-ti/layout-basic 8.4.0 → 8.6.0

package/dist/index.d.ts

@@ -68,6 +68,24 @@ interface HeaderContainerProps extends HTMLAttributes<HTMLDivElement> {
      */
     logoLink?: string;
     container?: boolean;
+    /**
+     * Conteúdo opcional exibido à esquerda dos `children` do cabeçalho — a área
+     * reservada para o sino de notificações.
+     *
+     * Não é renderizado quando omitido, então nenhum consumidor atual é afetado.
+     * O uso previsto é o componente `HeaderNotifications`, mas qualquer nó React
+     * é aceito.
+     *
+     * @example
+     * <HeaderContainer
+     *   onOpenMenu={toggleSidebar}
+     *   isOpen={collapsed}
+     *   notifications={<HeaderNotifications items={notificacoes} />}
+     * >
+     *   <HeaderProfileHeader user={usuario}>...</HeaderProfileHeader>
+     * </HeaderContainer>
+     */
+    notifications?: ReactNode;
 }
 declare const HeaderContainer: React.FC<HeaderContainerProps>;
 interface ProfileProps extends HTMLAttributes<HTMLDivElement> {
@@ -288,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;
 }
@@ -329,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.
@@ -439,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;
@@ -470,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;
@@ -579,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 {
@@ -619,4 +755,440 @@ interface CardListProps<T> {
 }
 declare function CardList<T>({ items, renderCard, emptyMessage, minItemWidth, className, gap, getKey, isLoading, skeletonCount, }: CardListProps<T>): 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, Filter, type FilterField, type FilterFieldType, type FilterProps, type FilterValues, Header, HeaderContainer, HeaderProfileHeader, HeaderProfileItem, type HeaderProps, Input, type InputProps, type ItemOption, Modal, ModalEntidade, ModalMudancaEntidade, type ModalProps, 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, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Title, availableApps, buttonVariants };
+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`. */
+interface Notificacao {
+    id: string | number;
+    sistema: string;
+    titulo: string;
+    mensagem?: string | null;
+    dataReferencia: string;
+    destinatarioEmail?: string | null;
+    status: StatusNotificacao;
+    statusLeitura: StatusLeitura;
+    metadados?: Record<string, unknown> | null;
+    lembrarNoDia?: boolean;
+    diasAntes?: number | null;
+    alertasDiasAntes?: number[] | null;
+    dataLembrete?: string | null;
+    disparado?: boolean;
+    criadoEm?: string | null;
+    criadoPor?: string | null;
+    disparadoEm?: string | null;
+    entregueEm?: string | null;
+    lidoEm?: string | null;
+    canceladoEm?: string | null;
+    concluidoEm?: string | null;
+    motivoCancelamento?: string | null;
+}
+interface HeaderNotificationItem {
+    /** Identificador único. Usado como `key` da lista. */
+    id: string | number;
+    /** Título da notificação. */
+    title: string;
+    /** Texto complementar, limitado a duas linhas. */
+    message?: string;
+    /** Data já formatada, ex.: "há 5 minutos". */
+    date?: string;
+    /** Quando `false` ou ausente, o item conta no badge e fica destacado. */
+    read?: boolean;
+    /** Destino sugerido, para a aplicação usar no `onSelect`. Não navega sozinho. */
+    href?: string;
+}
+interface HeaderNotificationsBaseProps {
+    /** Quantidade de skeletons durante o loading. @defaultValue 3 */
+    skeletonCount?: number;
+    /** Título do painel. @defaultValue "Notificações" */
+    title?: string;
+    /** Mensagem do estado vazio. @defaultValue "Nenhuma notificação" */
+    emptyMessage?: string;
+    /** A partir deste valor o badge exibe "N+". @defaultValue 9 */
+    maxCount?: number;
+    /**
+     * Ação extra no clique, além de marcar como lida. Só com ela o painel fecha
+     * e só com ela há navegação — o componente nunca navega por conta própria.
+     * Use `item.href`, preenchido por `getHref`, para decidir o destino.
+     */
+    onSelect?: (item: HeaderNotificationItem) => void;
+    /** Clique em uma notificação não lida, chamada antes de `onSelect`. */
+    onMarkAsRead?: (item: HeaderNotificationItem) => void;
+    /**
+     * Habilita o botão de marcar como não lida em cada item. No modo conectado o
+     * componente já faz a chamada; aqui a aplicação só é avisada.
+     */
+    onMarkAsUnread?: (item: HeaderNotificationItem) => void;
+    /**
+     * Habilita a lixeira em cada item. No modo conectado o componente já exclui
+     * na API; aqui a aplicação só é avisada. **A exclusão é definitiva.**
+     */
+    onDelete?: (item: HeaderNotificationItem) => void;
+    /** "Marcar todas como lidas", exibida só quando há não lidas. */
+    onMarkAllAsRead?: () => void;
+    /** Abertura e fechamento do painel. */
+    onOpenChange?: (open: boolean) => void;
+    /** Rodapé customizado. Substitui os botões padrão do rodapé. */
+    footer?: React$1.ReactNode;
+    /** Alinhamento do painel em relação ao sino. @defaultValue "end" */
+    align?: "start" | "center" | "end";
+    /** Classes adicionais do botão do sino. */
+    className?: string;
+    /** Classes adicionais do painel. */
+    contentClassName?: string;
+}
+/** Modo controlado: a aplicação busca e formata, o componente só exibe. */
+interface HeaderNotificationsControladoProps extends HeaderNotificationsBaseProps {
+    /** Notificações exibidas no painel. */
+    items?: HeaderNotificationItem[];
+    /** Quando `true`, exibe skeletons no lugar da lista. */
+    isLoading?: boolean;
+    /** Contagem do badge. Quando omitida, é derivada de `items`. */
+    unreadCount?: number;
+    email?: never;
+    sistema?: never;
+    baseUrl?: never;
+    getHref?: never;
+    filtros?: never;
+    intervaloAtualizacao?: never;
+    limite?: never;
+    onErro?: never;
+    alertarLembretes?: never;
+    tituloLembretes?: never;
+    rotuloDispensarLembretes?: never;
+}
+/** Modo conectado: o componente busca no serviço de notificações sozinho. */
+interface HeaderNotificationsConectadoProps extends HeaderNotificationsBaseProps {
+    /** E-mail do destinatário. Vira `?email=` no GET. */
+    email: string;
+    /** Identificador do sistema chamador, ex.: "gestao-demandas". */
+    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;
+    /**
+     * Preenche `item.href` a partir de `metadados`. **Não navega sozinho** — só
+     * serve para o `onSelect` da aplicação saber para onde ir. Sem `onSelect`, o
+     * clique apenas marca como lida.
+     */
+    getHref?: (notificacao: Notificacao) => string | undefined;
+    /** Filtros de metadado enviados na query, ex.: `{ demandaId: "123" }`. */
+    filtros?: Record<string, string>;
+    /** Intervalo do polling em ms. `0` desliga. @defaultValue 60000 */
+    intervaloAtualizacao?: number;
+    /** Corte client-side — a API não pagina. @defaultValue 20 */
+    limite?: number;
+    /** Recebe falhas de rede em vez de deixá-las silenciosas. */
+    onErro?: (erro: Error) => void;
+    /**
+     * Abre um modal ao carregar quando existe lembrete vencido — notificação com
+     * `lembrarNoDia` ligado e `dataLembrete` já vencido. Fechar o modal marca
+     * esses lembretes como lidos. @defaultValue false
+     */
+    alertarLembretes?: boolean;
+    /** Título do modal de lembretes. Por padrão varia com a quantidade. */
+    tituloLembretes?: string;
+    /** Texto do botão que dispensa o modal. @defaultValue "Entendi" */
+    rotuloDispensarLembretes?: string;
+    items?: never;
+    isLoading?: never;
+    unreadCount?: never;
+}
+type HeaderNotificationsProps = HeaderNotificationsControladoProps | HeaderNotificationsConectadoProps;
+
+/**
+ * Usada quando `baseUrl` não é informada. Aponta para o ambiente de
+ * desenvolvimento — em produção passe a prop explicitamente, senão a aplicação
+ * lê e grava no dev.
+ */
+declare const URL_PADRAO_NOTIFICACOES = "https://dev-apinotificacoes-b5feekb4bdfyb7c2.eastus2-01.azurewebsites.net/v1";
+declare class ErroNotificacoes extends Error {
+    readonly status?: number;
+    constructor(mensagem: string, status?: number);
+}
+
+/**
+ * Sino de notificações do cabeçalho: badge de não lidas, painel com a lista,
+ * estados de loading e vazio, marcar todas como lidas e atalho para a tela
+ * completa.
+ *
+ * Opera em dois modos, mutuamente exclusivos pelo tipo:
+ *
+ * **Conectado** — recebe `email` e `sistema` e cuida sozinho de buscar,
+ * formatar a data, filtrar o que já aconteceu e marcar como lida. `baseUrl` é
+ * opcional e cai em `URL_PADRAO_NOTIFICACOES`, que aponta para o ambiente de
+ * desenvolvimento — em produção passe a prop.
+ *
+ * **Controlado** — recebe `items` já prontos e devolve as interações por
+ * callback, sem fazer nenhuma requisição.
+ *
+ * @example
+ * <HeaderContainer
+ *   onOpenMenu={toggleSidebar}
+ *   isOpen={collapsed}
+ *   notifications={
+ *     <HeaderNotifications
+ *       email={sessao.user.email}
+ *       sistema="gestao-demandas"
+ *       getHref={(n) => `/demandas/${n.metadados?.demandaId}`}
+ *       onViewAll={() => router.push("/notificacoes")}
+ *     />
+ *   }
+ * >
+ *   <HeaderProfileHeader user={usuario}>...</HeaderProfileHeader>
+ * </HeaderContainer>
+ */
+declare function HeaderNotifications(props: HeaderNotificationsProps): react_jsx_runtime.JSX.Element;
+
+export { AplicationsHeader, type AppInput, type AppItem, AppsMenu, type AppsMenuProps, 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, 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, ErroNotificacoes, FileList, type FileListItem, type FileListProps, type FileRejection, type FileRejectionReason, FileUpload, type FileUploadProps, 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, 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, PageHeader, PageHeaderActionsContainer, PageHeaderTitle, PageHeaderTitleContent, type PeriodRange, type PeriodRangeInputType, PeriodRangeList, type PeriodRangeListLabels, type PeriodRangeListProps, type PeriodRangeListValidateOptions, Popover, PopoverContent, PopoverTrigger, ResultMetadata, type ResultMetadataGender, type ResultMetadataProps, 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, Textarea, type TextareaProps, Title, Tooltip, type TooltipProps, URL_PADRAO_NOTIFICACOES, type ValidateFilesOptions, availableApps, buildMonthDays, buttonVariants, formatDayAriaLabel, formatFileSize, formatMonthYear, isSameDay, isToday, toDateKey, toLocalNoon, useDrawer, validateFiles };