@cnc-ti/layout-basic 8.8.2 → 9.0.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as class_variance_authority_dist_types from 'class-variance-authority/dist/types';
 import { VariantProps } from 'class-variance-authority';
 import * as React$1 from 'react';
-import React__default, { HTMLAttributes, ReactNode, PropsWithChildren, ReactElement, ComponentProps, SVGProps, ElementType } from 'react';
+import React__default, { HTMLAttributes, ReactNode, PropsWithChildren, ComponentProps, ReactElement, SVGProps, ElementType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import { DialogProps } from '@radix-ui/react-dialog';
@@ -182,6 +182,89 @@ declare const DialogFooter: {
 declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 
+/**
+ * Estados possíveis da barra lateral.
+ *
+ * - `expanded` — largura total (280px no desktop, tela cheia no mobile), ícone + rótulo.
+ * - `mini` — largura reduzida (64px), somente ícones, rótulo exibido em tooltip.
+ * - `closed` — não renderizada. A reabertura é feita pelo botão de menu do `Header`.
+ */
+type SidebarState = "expanded" | "mini" | "closed";
+interface SidebarContextValue {
+    /** Estado atual da barra lateral. */
+    variant: SidebarState;
+    /** `true` quando a viewport está abaixo do breakpoint mobile. */
+    isMobile: boolean;
+    /**
+     * Solicita a mudança para outro estado. Encaminhado para o
+     * `onVariantChange` do `SidebarContainer`; sem ele, é um no-op.
+     */
+    requestState: (next: SidebarState) => void;
+}
+/**
+ * Acessa o estado da barra lateral a partir de qualquer subcomponente.
+ *
+ * Diferente do `useDrawer`, **não lança erro** fora do provider: devolve um
+ * estado expandido estático, preservando a compatibilidade com usos avulsos
+ * dos subcomponentes.
+ *
+ * @example
+ * const { variant, isMobile, requestState } = useSidebar();
+ * if (variant === "mini") { ... }
+ */
+declare function useSidebar(): SidebarContextValue;
+
+/** Breakpoint (px) abaixo do qual a barra lateral é tratada como mobile. */
+declare const SIDEBAR_MOBILE_BREAKPOINT = 768;
+interface UseSidebarBreakpointOptions {
+    /**
+     * Largura (px) abaixo da qual a barra lateral entra em modo mobile.
+     * @default 768
+     */
+    mobileBreakpoint?: number;
+    /**
+     * Estado inicial usado antes da primeira medição da viewport.
+     * Relevante em SSR, onde `window` não existe.
+     * @default "expanded"
+     */
+    defaultState?: SidebarState;
+}
+interface UseSidebarBreakpointResult {
+    /** `true` quando a viewport está abaixo de `mobileBreakpoint`. */
+    isMobile: boolean;
+    /**
+     * Estado sugerido para o breakpoint atual: `closed` no mobile,
+     * `expanded` no desktop. É uma sugestão — o consumidor decide se aplica.
+     */
+    suggested: SidebarState;
+    /**
+     * Próximo estado ao acionar o toggle, a partir de `current`.
+     *
+     * - Mobile: alterna `closed` ↔ `expanded` (não existe `mini`).
+     * - Desktop: alterna `expanded` ↔ `mini`.
+     */
+    getNextState: (current: SidebarState) => SidebarState;
+}
+/**
+ * Calcula o estado da barra lateral a partir da largura da viewport.
+ *
+ * Não controla nada sozinho: devolve o estado sugerido e a função de
+ * transição, cabendo ao consumidor aplicar (ou não). É o mesmo comportamento
+ * já validado em produção no gestão de eventos e no gestão de demandas.
+ *
+ * @example
+ * const [variant, setVariant] = useState<SidebarState>("expanded");
+ * const { isMobile, suggested, getNextState } = useSidebarBreakpoint();
+ *
+ * useEffect(() => setVariant(suggested), [suggested]);
+ *
+ * <SidebarContainer
+ *   variant={variant}
+ *   onVariantChange={setVariant}
+ * />
+ */
+declare function useSidebarBreakpoint(options?: UseSidebarBreakpointOptions): UseSidebarBreakpointResult;
+
 /**
  * Propriedades para o componente SidebarContainer.
  *
@@ -190,31 +273,78 @@ declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPr
 interface SidebarContainerProps extends React__default.HTMLAttributes<HTMLDivElement> {
     /**
      * Indica se o sidebar está aberto ou fechado.
+     *
+     * @deprecated Desde a v9, use `variant`. Mantida para compatibilidade:
+     * `true` equivale a `"expanded"` e `false` a `"closed"`. Quando `variant`
+     * é informada, esta prop é ignorada.
      * @default true
      */
     isOpen?: boolean;
+    /**
+     * Estado visual da barra lateral. Tem precedência sobre `isOpen`.
+     * @default "expanded"
+     */
+    variant?: SidebarState;
+    /**
+     * Chamada quando um subcomponente solicita a mudança de estado — pelo botão
+     * de alternância do `SidebarImageBrand` ou pelo clique em um item de
+     * navegação no mobile. A barra lateral é controlada: cabe ao consumidor
+     * aplicar o novo estado.
+     */
+    onVariantChange?: (next: SidebarState) => void;
+    /**
+     * Largura (px) abaixo da qual a barra lateral é tratada como mobile.
+     * @default 768
+     */
+    mobileBreakpoint?: number;
 }
-declare function SidebarContainer({ isOpen, ...rest }: SidebarContainerProps): react_jsx_runtime.JSX.Element;
+/**
+ * Container da barra lateral, responsável pela largura, pela transição entre
+ * estados e por prover o contexto consumido pelos demais subcomponentes.
+ *
+ * No estado `closed` **nada é renderizado** — a reabertura fica a cargo do
+ * botão de menu do `HeaderContainer`.
+ */
+declare function SidebarContainer({ isOpen, variant, onVariantChange, mobileBreakpoint, className, style, children, ...rest }: SidebarContainerProps): react_jsx_runtime.JSX.Element;
 interface SidebarImageBrandProps extends PropsWithChildren {
-    /** @param {boolean} [props.asChild=false] - Se `true`, e `children` for um elemento React válido, este será usado como logotipo. Se `img` também for fornecido, `img` terá precedência. Se `children` não for um elemento React válido, o comportamento padrão de exibir a imagem de `img` ou `children` como conteúdo será usado. */
+    /** @param {boolean} [props.asChild=false] - Se `true`, e `children` for um elemento React válido, este será usado como logotipo. Se `img` também for fornecido, `img` terá precedência. */
     asChild?: boolean;
-    /** @param {{ src?: string; alt?: string }} [props.img] - Objeto com as propriedades `src` e `alt` da imagem, usado quando `asChild` é `false` ou quando `asChild` é `true` mas `children` não é um elemento React válido para ser usado como logotipo. */
+    /** @param {{ src?: string; alt?: string }} [props.img] - Objeto com as propriedades `src` e `alt` da imagem. */
     img?: {
         src?: string;
         alt?: string;
     };
-    /** @param {ReactNode} [props.children] - Conteúdo personalizado ou elemento filho a ser exibido como logotipo quando `asChild` for `true` e `img` não for fornecido.  Normalmente usado para o botão de toggle ou um logotipo customizado. */
+    /** @param {ReactNode} [props.children] - Conteúdo personalizado exibido como logotipo quando `asChild` for `true`. */
     children?: ReactNode;
+    /**
+     * Chamada ao clicar no botão de alternância.
+     *
+     * @deprecated Desde a v9, use `onToggleRequest`, que recebe o próximo
+     * estado já calculado. Quando as duas são informadas, ambas são chamadas.
+     */
     onChangeToggle?: () => void;
+    /**
+     * Chamada ao clicar no botão de alternância, com o próximo estado sugerido
+     * pelo breakpoint atual (`mini`/`expanded` no desktop, `closed`/`expanded`
+     * no mobile). O consumidor decide se aplica.
+     *
+     * Quando omitida, a solicitação é encaminhada ao `onVariantChange` do
+     * `SidebarContainer`.
+     */
+    onToggleRequest?: (next: SidebarState) => void;
+    /**
+     * Exibe o botão de alternância. Desligue quando o controle ficar a cargo
+     * do `Header`.
+     * @default true
+     */
+    showToggle?: boolean;
 }
 /**
- * Componente para exibir a imagem da marca (logotipo) na barra lateral.
+ * Cabeçalho da barra lateral: exibe o logotipo e o botão de alternância.
  *
- * Exibe uma imagem, um elemento filho como logotipo ou conteúdo personalizado na parte superior da barra lateral.
- * Permite a inclusão de um botão de alternância (toggle) para colapsar a barra lateral.
- * A prop `asChild` permite usar um elemento filho como logotipo, caso a prop `img` não seja fornecida.
+ * No estado `mini` o logotipo é omitido e o botão fica centralizado.
  */
-declare function SidebarImageBrand({ asChild, onChangeToggle, img, children, }: SidebarImageBrandProps): react_jsx_runtime.JSX.Element;
+declare function SidebarImageBrand({ asChild, onChangeToggle, onToggleRequest, showToggle, img, children, }: SidebarImageBrandProps): react_jsx_runtime.JSX.Element;
 type AccordionRootProps = ComponentProps<typeof Accordion.Root>;
 type SidebarProps = AccordionRootProps & {
     /** @param {ReactNode} props.children - Os elementos filhos a serem renderizados dentro do Sidebar. */
@@ -223,25 +353,24 @@ type SidebarProps = AccordionRootProps & {
     type: AccordionRootProps["type"];
 };
 /**
- * Componente Sidebar, responsável por renderizar a estrutura principal do menu lateral
- * e gerenciar o comportamento de acordeão dos itens de navegação.
- *
- * Este componente utiliza o Radix UI Accordion para controlar a expansão e o colapso
- * dos itens do menu. O tipo de acordeão (único ou múltiplo) é determinado pela propriedade `type`.
+ * Área de navegação da barra lateral, com comportamento de acordeão para os
+ * itens do tipo `SidebarNavCollapse`.
  *
  * Estende as tipagens do componente `Accordion.Root` do Radix UI.
  */
-declare function Sidebar({ children, ...rest }: SidebarProps): react_jsx_runtime.JSX.Element;
+declare function Sidebar({ children, className, ...rest }: SidebarProps): react_jsx_runtime.JSX.Element;
+interface IconProps extends SVGProps<SVGSVGElement> {
+}
+type SidebarIcon = ReactElement<IconProps> | ReactNode;
 /**
  * Componente de link de navegação para o Sidebar.
  *
- * Renderiza um link com ícone e título, permitindo navegação dentro do Sidebar.
- * Recomenda-se que o ícone fornecido tenha 20px de altura e largura para
- * consistência visual.
+ * A partir da v9, prefira as props `icon` e `label` em lugar de `children`:
+ * elas são o que permite ao estado `mini` ocultar o rótulo e exibi-lo em um
+ * tooltip. O formato antigo continua funcionando, com aviso no console.
  *
- * @param {SidebarNavLinkProps} props - As propriedades do componente.
- * @param {ReactNode} props.children - O título do link e o icone que pode ser fornecido como componente ou svg (🚨recomendado 20px x 20px).
- * @param {string} props.href O caminho para redirecionamento.
+ * @example
+ * <SidebarNavLink href="/" icon={<IconHome />} label="Início" ativo />
  */
 interface SidebarNavLinkProps extends React__default.AnchorHTMLAttributes<HTMLAnchorElement> {
     asChild?: boolean;
@@ -250,15 +379,33 @@ interface SidebarNavLinkProps extends React__default.AnchorHTMLAttributes<HTMLAn
      * @default 'primary'
      */
     type?: "primary" | "secondary";
+    /** Ícone do item (recomendado 20px x 20px). Necessário para o estado `mini`. */
+    icon?: SidebarIcon;
+    /** Rótulo do item. Ocultado no estado `mini`, onde vira tooltip. */
+    label?: ReactNode;
+    /** Destaca o item como o da rota atual. */
+    ativo?: boolean;
+    /** Desabilita o item: remove do fluxo de foco e ignora cliques. */
+    disabled?: boolean;
+    /**
+     * Impede o fechamento automático da barra lateral no mobile ao clicar.
+     * @default false
+     */
+    keepOpenOnClick?: boolean;
 }
-declare function SidebarNavLink({ asChild, type, ...rest }: SidebarNavLinkProps): react_jsx_runtime.JSX.Element;
-interface IconProps extends SVGProps<SVGSVGElement> {
-}
+declare function SidebarNavLink({ asChild, type, icon, label, ativo, disabled, keepOpenOnClick, className, children, onClick, ...rest }: SidebarNavLinkProps): react_jsx_runtime.JSX.Element;
 interface SidebarNavCollapseProps extends Accordion.AccordionItemProps {
     title: string;
-    icon?: ReactElement<IconProps> | ReactNode;
+    icon?: SidebarIcon;
 }
-declare function SidebarNavCollapse({ children, title, icon, ...rest }: SidebarNavCollapseProps): react_jsx_runtime.JSX.Element;
+/**
+ * Item de navegação com submenu.
+ *
+ * No estado `expanded` funciona como acordeão. No estado `mini` não há
+ * largura para expandir inline, então o submenu passa a ser exibido em um
+ * flyout lateral, ancorado no ícone.
+ */
+declare function SidebarNavCollapse({ children, title, icon, className, ...rest }: SidebarNavCollapseProps): react_jsx_runtime.JSX.Element;
 
 declare const Popover: React$1.FC<PopoverPrimitive.PopoverProps>;
 declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -1349,4 +1496,4 @@ interface RetornoUsarAlertas {
 }
 declare function usarAlertas({ baseUrl, sistema, email, fetchFn, eventoId, filtros, 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 };
+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, SIDEBAR_MOBILE_BREAKPOINT, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectPortal, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectViewport, Sidebar, SidebarContainer, type SidebarContainerProps, type SidebarContextValue, SidebarImageBrand, type SidebarImageBrandProps, SidebarNavCollapse, type SidebarNavCollapseProps, SidebarNavLink, type SidebarNavLinkProps, type SidebarProps, type SidebarState, type StatusAlerta, type StatusLeitura, type StatusNotificacao, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Title, Tooltip, type TooltipProps, URL_PADRAO_NOTIFICACOES, type UseSidebarBreakpointOptions, type UseSidebarBreakpointResult, type ValidateFilesOptions, availableApps, buildMonthDays, buscarAlertas, buttonVariants, formatDayAriaLabel, formatFileSize, formatMonthYear, isSameDay, isToday, normalizarBaseUrl, toDateKey, toLocalNoon, usarAlertas, useDrawer, useSidebar, useSidebarBreakpoint, validateFiles };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as class_variance_authority_dist_types from 'class-variance-authority/dist/types';
 import { VariantProps } from 'class-variance-authority';
 import * as React$1 from 'react';
-import React__default, { HTMLAttributes, ReactNode, PropsWithChildren, ReactElement, ComponentProps, SVGProps, ElementType } from 'react';
+import React__default, { HTMLAttributes, ReactNode, PropsWithChildren, ComponentProps, ReactElement, SVGProps, ElementType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import { DialogProps } from '@radix-ui/react-dialog';
@@ -182,6 +182,89 @@ declare const DialogFooter: {
 declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 
+/**
+ * Estados possíveis da barra lateral.
+ *
+ * - `expanded` — largura total (280px no desktop, tela cheia no mobile), ícone + rótulo.
+ * - `mini` — largura reduzida (64px), somente ícones, rótulo exibido em tooltip.
+ * - `closed` — não renderizada. A reabertura é feita pelo botão de menu do `Header`.
+ */
+type SidebarState = "expanded" | "mini" | "closed";
+interface SidebarContextValue {
+    /** Estado atual da barra lateral. */
+    variant: SidebarState;
+    /** `true` quando a viewport está abaixo do breakpoint mobile. */
+    isMobile: boolean;
+    /**
+     * Solicita a mudança para outro estado. Encaminhado para o
+     * `onVariantChange` do `SidebarContainer`; sem ele, é um no-op.
+     */
+    requestState: (next: SidebarState) => void;
+}
+/**
+ * Acessa o estado da barra lateral a partir de qualquer subcomponente.
+ *
+ * Diferente do `useDrawer`, **não lança erro** fora do provider: devolve um
+ * estado expandido estático, preservando a compatibilidade com usos avulsos
+ * dos subcomponentes.
+ *
+ * @example
+ * const { variant, isMobile, requestState } = useSidebar();
+ * if (variant === "mini") { ... }
+ */
+declare function useSidebar(): SidebarContextValue;
+
+/** Breakpoint (px) abaixo do qual a barra lateral é tratada como mobile. */
+declare const SIDEBAR_MOBILE_BREAKPOINT = 768;
+interface UseSidebarBreakpointOptions {
+    /**
+     * Largura (px) abaixo da qual a barra lateral entra em modo mobile.
+     * @default 768
+     */
+    mobileBreakpoint?: number;
+    /**
+     * Estado inicial usado antes da primeira medição da viewport.
+     * Relevante em SSR, onde `window` não existe.
+     * @default "expanded"
+     */
+    defaultState?: SidebarState;
+}
+interface UseSidebarBreakpointResult {
+    /** `true` quando a viewport está abaixo de `mobileBreakpoint`. */
+    isMobile: boolean;
+    /**
+     * Estado sugerido para o breakpoint atual: `closed` no mobile,
+     * `expanded` no desktop. É uma sugestão — o consumidor decide se aplica.
+     */
+    suggested: SidebarState;
+    /**
+     * Próximo estado ao acionar o toggle, a partir de `current`.
+     *
+     * - Mobile: alterna `closed` ↔ `expanded` (não existe `mini`).
+     * - Desktop: alterna `expanded` ↔ `mini`.
+     */
+    getNextState: (current: SidebarState) => SidebarState;
+}
+/**
+ * Calcula o estado da barra lateral a partir da largura da viewport.
+ *
+ * Não controla nada sozinho: devolve o estado sugerido e a função de
+ * transição, cabendo ao consumidor aplicar (ou não). É o mesmo comportamento
+ * já validado em produção no gestão de eventos e no gestão de demandas.
+ *
+ * @example
+ * const [variant, setVariant] = useState<SidebarState>("expanded");
+ * const { isMobile, suggested, getNextState } = useSidebarBreakpoint();
+ *
+ * useEffect(() => setVariant(suggested), [suggested]);
+ *
+ * <SidebarContainer
+ *   variant={variant}
+ *   onVariantChange={setVariant}
+ * />
+ */
+declare function useSidebarBreakpoint(options?: UseSidebarBreakpointOptions): UseSidebarBreakpointResult;
+
 /**
  * Propriedades para o componente SidebarContainer.
  *
@@ -190,31 +273,78 @@ declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPr
 interface SidebarContainerProps extends React__default.HTMLAttributes<HTMLDivElement> {
     /**
      * Indica se o sidebar está aberto ou fechado.
+     *
+     * @deprecated Desde a v9, use `variant`. Mantida para compatibilidade:
+     * `true` equivale a `"expanded"` e `false` a `"closed"`. Quando `variant`
+     * é informada, esta prop é ignorada.
      * @default true
      */
     isOpen?: boolean;
+    /**
+     * Estado visual da barra lateral. Tem precedência sobre `isOpen`.
+     * @default "expanded"
+     */
+    variant?: SidebarState;
+    /**
+     * Chamada quando um subcomponente solicita a mudança de estado — pelo botão
+     * de alternância do `SidebarImageBrand` ou pelo clique em um item de
+     * navegação no mobile. A barra lateral é controlada: cabe ao consumidor
+     * aplicar o novo estado.
+     */
+    onVariantChange?: (next: SidebarState) => void;
+    /**
+     * Largura (px) abaixo da qual a barra lateral é tratada como mobile.
+     * @default 768
+     */
+    mobileBreakpoint?: number;
 }
-declare function SidebarContainer({ isOpen, ...rest }: SidebarContainerProps): react_jsx_runtime.JSX.Element;
+/**
+ * Container da barra lateral, responsável pela largura, pela transição entre
+ * estados e por prover o contexto consumido pelos demais subcomponentes.
+ *
+ * No estado `closed` **nada é renderizado** — a reabertura fica a cargo do
+ * botão de menu do `HeaderContainer`.
+ */
+declare function SidebarContainer({ isOpen, variant, onVariantChange, mobileBreakpoint, className, style, children, ...rest }: SidebarContainerProps): react_jsx_runtime.JSX.Element;
 interface SidebarImageBrandProps extends PropsWithChildren {
-    /** @param {boolean} [props.asChild=false] - Se `true`, e `children` for um elemento React válido, este será usado como logotipo. Se `img` também for fornecido, `img` terá precedência. Se `children` não for um elemento React válido, o comportamento padrão de exibir a imagem de `img` ou `children` como conteúdo será usado. */
+    /** @param {boolean} [props.asChild=false] - Se `true`, e `children` for um elemento React válido, este será usado como logotipo. Se `img` também for fornecido, `img` terá precedência. */
     asChild?: boolean;
-    /** @param {{ src?: string; alt?: string }} [props.img] - Objeto com as propriedades `src` e `alt` da imagem, usado quando `asChild` é `false` ou quando `asChild` é `true` mas `children` não é um elemento React válido para ser usado como logotipo. */
+    /** @param {{ src?: string; alt?: string }} [props.img] - Objeto com as propriedades `src` e `alt` da imagem. */
     img?: {
         src?: string;
         alt?: string;
     };
-    /** @param {ReactNode} [props.children] - Conteúdo personalizado ou elemento filho a ser exibido como logotipo quando `asChild` for `true` e `img` não for fornecido.  Normalmente usado para o botão de toggle ou um logotipo customizado. */
+    /** @param {ReactNode} [props.children] - Conteúdo personalizado exibido como logotipo quando `asChild` for `true`. */
     children?: ReactNode;
+    /**
+     * Chamada ao clicar no botão de alternância.
+     *
+     * @deprecated Desde a v9, use `onToggleRequest`, que recebe o próximo
+     * estado já calculado. Quando as duas são informadas, ambas são chamadas.
+     */
     onChangeToggle?: () => void;
+    /**
+     * Chamada ao clicar no botão de alternância, com o próximo estado sugerido
+     * pelo breakpoint atual (`mini`/`expanded` no desktop, `closed`/`expanded`
+     * no mobile). O consumidor decide se aplica.
+     *
+     * Quando omitida, a solicitação é encaminhada ao `onVariantChange` do
+     * `SidebarContainer`.
+     */
+    onToggleRequest?: (next: SidebarState) => void;
+    /**
+     * Exibe o botão de alternância. Desligue quando o controle ficar a cargo
+     * do `Header`.
+     * @default true
+     */
+    showToggle?: boolean;
 }
 /**
- * Componente para exibir a imagem da marca (logotipo) na barra lateral.
+ * Cabeçalho da barra lateral: exibe o logotipo e o botão de alternância.
  *
- * Exibe uma imagem, um elemento filho como logotipo ou conteúdo personalizado na parte superior da barra lateral.
- * Permite a inclusão de um botão de alternância (toggle) para colapsar a barra lateral.
- * A prop `asChild` permite usar um elemento filho como logotipo, caso a prop `img` não seja fornecida.
+ * No estado `mini` o logotipo é omitido e o botão fica centralizado.
  */
-declare function SidebarImageBrand({ asChild, onChangeToggle, img, children, }: SidebarImageBrandProps): react_jsx_runtime.JSX.Element;
+declare function SidebarImageBrand({ asChild, onChangeToggle, onToggleRequest, showToggle, img, children, }: SidebarImageBrandProps): react_jsx_runtime.JSX.Element;
 type AccordionRootProps = ComponentProps<typeof Accordion.Root>;
 type SidebarProps = AccordionRootProps & {
     /** @param {ReactNode} props.children - Os elementos filhos a serem renderizados dentro do Sidebar. */
@@ -223,25 +353,24 @@ type SidebarProps = AccordionRootProps & {
     type: AccordionRootProps["type"];
 };
 /**
- * Componente Sidebar, responsável por renderizar a estrutura principal do menu lateral
- * e gerenciar o comportamento de acordeão dos itens de navegação.
- *
- * Este componente utiliza o Radix UI Accordion para controlar a expansão e o colapso
- * dos itens do menu. O tipo de acordeão (único ou múltiplo) é determinado pela propriedade `type`.
+ * Área de navegação da barra lateral, com comportamento de acordeão para os
+ * itens do tipo `SidebarNavCollapse`.
  *
  * Estende as tipagens do componente `Accordion.Root` do Radix UI.
  */
-declare function Sidebar({ children, ...rest }: SidebarProps): react_jsx_runtime.JSX.Element;
+declare function Sidebar({ children, className, ...rest }: SidebarProps): react_jsx_runtime.JSX.Element;
+interface IconProps extends SVGProps<SVGSVGElement> {
+}
+type SidebarIcon = ReactElement<IconProps> | ReactNode;
 /**
  * Componente de link de navegação para o Sidebar.
  *
- * Renderiza um link com ícone e título, permitindo navegação dentro do Sidebar.
- * Recomenda-se que o ícone fornecido tenha 20px de altura e largura para
- * consistência visual.
+ * A partir da v9, prefira as props `icon` e `label` em lugar de `children`:
+ * elas são o que permite ao estado `mini` ocultar o rótulo e exibi-lo em um
+ * tooltip. O formato antigo continua funcionando, com aviso no console.
  *
- * @param {SidebarNavLinkProps} props - As propriedades do componente.
- * @param {ReactNode} props.children - O título do link e o icone que pode ser fornecido como componente ou svg (🚨recomendado 20px x 20px).
- * @param {string} props.href O caminho para redirecionamento.
+ * @example
+ * <SidebarNavLink href="/" icon={<IconHome />} label="Início" ativo />
  */
 interface SidebarNavLinkProps extends React__default.AnchorHTMLAttributes<HTMLAnchorElement> {
     asChild?: boolean;
@@ -250,15 +379,33 @@ interface SidebarNavLinkProps extends React__default.AnchorHTMLAttributes<HTMLAn
      * @default 'primary'
      */
     type?: "primary" | "secondary";
+    /** Ícone do item (recomendado 20px x 20px). Necessário para o estado `mini`. */
+    icon?: SidebarIcon;
+    /** Rótulo do item. Ocultado no estado `mini`, onde vira tooltip. */
+    label?: ReactNode;
+    /** Destaca o item como o da rota atual. */
+    ativo?: boolean;
+    /** Desabilita o item: remove do fluxo de foco e ignora cliques. */
+    disabled?: boolean;
+    /**
+     * Impede o fechamento automático da barra lateral no mobile ao clicar.
+     * @default false
+     */
+    keepOpenOnClick?: boolean;
 }
-declare function SidebarNavLink({ asChild, type, ...rest }: SidebarNavLinkProps): react_jsx_runtime.JSX.Element;
-interface IconProps extends SVGProps<SVGSVGElement> {
-}
+declare function SidebarNavLink({ asChild, type, icon, label, ativo, disabled, keepOpenOnClick, className, children, onClick, ...rest }: SidebarNavLinkProps): react_jsx_runtime.JSX.Element;
 interface SidebarNavCollapseProps extends Accordion.AccordionItemProps {
     title: string;
-    icon?: ReactElement<IconProps> | ReactNode;
+    icon?: SidebarIcon;
 }
-declare function SidebarNavCollapse({ children, title, icon, ...rest }: SidebarNavCollapseProps): react_jsx_runtime.JSX.Element;
+/**
+ * Item de navegação com submenu.
+ *
+ * No estado `expanded` funciona como acordeão. No estado `mini` não há
+ * largura para expandir inline, então o submenu passa a ser exibido em um
+ * flyout lateral, ancorado no ícone.
+ */
+declare function SidebarNavCollapse({ children, title, icon, className, ...rest }: SidebarNavCollapseProps): react_jsx_runtime.JSX.Element;
 
 declare const Popover: React$1.FC<PopoverPrimitive.PopoverProps>;
 declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -1349,4 +1496,4 @@ interface RetornoUsarAlertas {
 }
 declare function usarAlertas({ baseUrl, sistema, email, fetchFn, eventoId, filtros, 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 };
+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, SIDEBAR_MOBILE_BREAKPOINT, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectPortal, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectViewport, Sidebar, SidebarContainer, type SidebarContainerProps, type SidebarContextValue, SidebarImageBrand, type SidebarImageBrandProps, SidebarNavCollapse, type SidebarNavCollapseProps, SidebarNavLink, type SidebarNavLinkProps, type SidebarProps, type SidebarState, type StatusAlerta, type StatusLeitura, type StatusNotificacao, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Title, Tooltip, type TooltipProps, URL_PADRAO_NOTIFICACOES, type UseSidebarBreakpointOptions, type UseSidebarBreakpointResult, type ValidateFilesOptions, availableApps, buildMonthDays, buscarAlertas, buttonVariants, formatDayAriaLabel, formatFileSize, formatMonthYear, isSameDay, isToday, normalizarBaseUrl, toDateKey, toLocalNoon, usarAlertas, useDrawer, useSidebar, useSidebarBreakpoint, validateFiles };