negodesign 0.0.30 → 0.0.31

package/dist/components/core/banner/CtaCardBanner.svelte

@@ -76,7 +76,7 @@
 {/snippet}
 
 <article
-  class="relative isolate overflow-hidden rounded-3xl bg-gradient p-1 shadow-sm {className}"
+  class="relative isolate overflow-hidden rounded-lg bg-gradient p-1 shadow-sm {className}"
 >
   <div
     class="relative overflow-hidden rounded-[1.35rem] px-6 py-10 sm:px-10 sm:py-12"

package/dist/components/core/banner/types.d.ts

@@ -1,24 +1,34 @@
+/** Props do componente AdCardBanner — banner de anúncio com faixa lateral colorida e CTA. */
 export type BannerProps = {
-    /** Text shown stacked inside the amber side strip, e.g. "Este anúncio pode ser seu." */
+    /** Texto mostrado na faixa lateral colorida, ex: "Este anúncio pode ser seu." */
     tagText: string;
-    /** First part of the headline (rendered in the amber accent color) */
+    /** Primeira parte do título (renderizada na cor de destaque âmbar) */
     titleHighlight: string;
-    /** Second part of the headline (rendered in the green accent color) */
+    /** Segunda parte do título (renderizada na cor verde de destaque) */
     titleMain: string;
-    /** CTA button label */
+    /** Texto do botão CTA */
     buttonText?: string;
-    /** Called when the CTA button is clicked */
+    /** Chamado quando o botão CTA é clicado */
     onClickButton?: () => void;
-    /** Optional href — if provided, the whole card navigates on click */
+    /** href opcional — se fornecido, todo o card navega ao clicar */
     href?: string;
+    /** Classe CSS adicional para o container */
     class?: string;
+    /** Classe CSS para a parte highlight do título */
     titleHighlightClass?: string;
+    /** Classe CSS para a parte principal do título */
     titleMainClass?: string;
+    /** Classe CSS para o fundo do título */
     titleBgClass?: string;
+    /** Classe CSS para o texto da tag lateral */
     tagTextClass?: string;
+    /** Classe CSS para o botão */
     buttonClass?: string;
+    /** Classe CSS para o fundo da tag lateral */
     tagBgClass?: string;
 };
+/** Alias para BannerProps — props do componente AdCardBanner. */
+export type AdCardBannerProps = BannerProps;
 export type NotificationBannerProps = {
     /** Strong text before the separator, e.g. "GeneriCon 2023" */
     strongText?: string;

package/dist/components/core/card/types.d.ts

@@ -1,85 +1,179 @@
 import type { IconSvgElement } from "@hugeicons/svelte";
+/**
+ * Props de uma tag individual usada nos cards.
+ * Usada em CardMedia, CardProfile, CardPromotion e CardHighlight.
+ */
 export interface CardTagsProps {
+    /** Ícone opcional exibido antes do texto da tag */
     icon?: IconSvgElement;
+    /** Texto exibido na tag */
     text: string;
 }
+/**
+ * Props do CardMedia — card de mídia com imagem ou vídeo,
+ * tags, rating, botões de perfil e detalhes.
+ */
 export interface CardMediaProps {
+    /** Identificador único do item */
     id: string | number;
+    /** URL do logotipo da empresa/organização */
     logo?: string;
+    /** Título do card (nome do produto, serviço, etc.) */
     title?: string;
+    /** Descrição/conteúdo do card */
     content?: string;
+    /** Valor máximo da classificação por estrelas (ex: 5) */
     startMax?: number;
+    /** URL da imagem de capa */
     imageUrl?: string;
+    /** URL do vídeo (substitui a imagem quando fornecido) */
     videoUrl?: string;
+    /** Classe CSS adicional para o container */
     className?: string;
+    /** Lista de tags exibidas no card */
     tags?: CardTagsProps[];
+    /** Indica se o item está marcado como favorito */
     isFavorite?: boolean;
+    /** Indica estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Valor atual da classificação por estrelas (ex: 4.5) */
     startNumber?: number;
+    /** Exibe borda inferior nas tags */
     isTagBorderBottom?: boolean;
+    /** Classe CSS personalizada para o botão de perfil */
     buttonProfileClass?: string;
+    /** Classe CSS personalizada para o botão de detalhes */
     buttonDetailsClass?: string;
+    /** Exibe o botão de maximizar no vídeo */
     isVideoButtonMaximized?: boolean;
+    /** Exibe o botão de maximizar na imagem */
     isImageButtonMaximized?: boolean;
+    /** Callback acionado ao clicar no botão de favorito */
     onFavoriteClick?: (id: string | number) => void;
+    /** Callback acionado ao clicar no botão de perfil */
     onButtonProfile?: (id: string | number) => void;
+    /** Callback acionado ao clicar no botão de detalhes */
     onButtonDetails?: (id: string | number) => void;
+    /** Comportamento do vídeo: iniciar reprodução automática ou no hover */
     videoAction?: 'START_REPRODUCTION' | 'HOVER_REPRODUCTION';
 }
+/**
+ * Props do CardProfile — card de perfil de organização/guia
+ * com logo, descrição, tags, rating e botões.
+ */
 export interface CardProfileProps {
+    /** Identificador único do perfil */
     id: string | number;
+    /** URL do logotipo/avatar */
     logo?: string;
+    /** Nome/título do perfil */
     title?: string;
+    /** Descrição do perfil */
     content?: string;
+    /** Valor máximo da classificação por estrelas */
     startMax?: number;
+    /** Classe CSS adicional */
     className?: string;
+    /** Lista de tags do perfil */
     tags?: CardTagsProps[];
+    /** Indica se está marcado como favorito */
     isFavorite?: boolean;
+    /** Valor da classificação por estrelas */
     startNumber?: number;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Exibe borda inferior nas tags */
     isTagBorderBottom?: boolean;
+    /** Classe CSS personalizada para botão de perfil */
     buttonProfileClass?: string;
+    /** Classe CSS personalizada para botão de detalhes */
     buttonDetailsClass?: string;
+    /** Callback ao clicar no botão favorito */
     onFavoriteClick?: (id: string | number) => void;
+    /** Callback ao clicar no botão perfil */
     onButtonProfile?: (id: string | number) => void;
+    /** Callback ao clicar no botão detalhes */
     onButtonDetails?: (id: string | number) => void;
 }
+/**
+ * Props do CardPromotion — card de promoção com preço antigo/novo,
+ * botão de comprar, favoritar e adicionar ao carrinho.
+ */
 export interface CardPromotionProps {
+    /** Identificador único da promoção */
     id: string | number;
+    /** URL do logotipo */
     logo?: string;
+    /** URL da imagem do produto em promoção */
     imageUrl?: string;
+    /** Nome/título da promoção */
     title?: string;
+    /** Descrição da promoção */
     content?: string;
+    /** Classe CSS adicional */
     className?: string;
+    /** Indica se o botão de carrinho está ativo */
     isCart?: boolean;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Indica se está marcado como favorito */
     isFavorite?: boolean;
+    /** Lista de tags */
     tags?: CardTagsProps[];
+    /** Preço original (antes do desconto) */
     oldPrice?: string | number;
+    /** Preço promocional */
     newPrice?: string | number;
+    /** Texto do botão de compra (padrão: "Comprar") */
     buttonBuyText?: string;
+    /** Classe CSS personalizada para o botão comprar */
     buttonBuyClass?: string;
+    /** Exibe ícone antes da descrição */
     isDescriptionIcon?: boolean;
+    /** Exibe etiqueta (label) na descrição */
     isDescriptionLabel?: boolean;
+    /** Callback ao clicar no botão comprar */
     onClickBuy?: (id: string | number) => void;
+    /** Callback ao clicar no botão carrinho */
     onClickShop?: (id: string | number) => void;
+    /** Callback ao clicar no botão favorito */
     onClickFavorite?: (id: string | number) => void;
 }
+/**
+ * Props do CardHighlight — card de destaque/organização
+ * com imagem, logo, botão de ação expandida.
+ */
 export interface CardHighlightProps {
+    /** Identificador único do destaque */
     id: string | number;
+    /** URL do logotipo */
     logo?: string;
+    /** URL da imagem de destaque */
     imageUrl?: string;
+    /** Título/nome do destaque */
     title?: string;
+    /** Classe CSS adicional */
     className?: string;
+    /** Indica se está marcado como favorito */
     isFavorite?: boolean;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Exibe botão expandir/ver mais */
     isExpandButton?: boolean;
+    /** Descrição do destaque */
     content?: string;
+    /** Texto do botão de ação principal */
     buttonText?: string;
+    /** Classe CSS personalizada para o botão */
     buttonClass?: string;
+    /** Exibe ícone antes da descrição */
     isDescriptionIcon?: boolean;
+    /** Exibe etiqueta (label) na descrição */
     isDescriptionLabel?: boolean;
+    /** Lista de tags */
     tags?: CardTagsProps[];
+    /** Callback ao clicar no botão favorito */
     onClickFavorite?: (id: string | number) => void;
+    /** Callback ao clicar no botão principal */
     onClickBtn?: (id: string | number) => void;
 }

package/dist/components/core/carousel/grid/media/types.d.ts

@@ -1,11 +1,21 @@
 import type { CardMediaProps } from "../../../card/types";
 import type { CarouselSlotProps } from "../../../panel/type";
 import type { CarouselHeaderProps } from "../../types";
+/**
+ * Props do CarouselGridMedia — layout em grid de cards de mídia
+ * (imagens/vídeos). Em telas mobile o grid vira carousel com swipe.
+ */
 export interface CarouselMediaProps {
+    /** Props do cabeçalho do carousel (título, descrição, etc.) */
     headerProps?: CarouselHeaderProps;
+    /** Props do slot/container do carousel (botões navegação, plugins) */
     slotProps?: CarouselSlotProps;
+    /** Classe CSS adicional para o container do grid */
     gridClass?: string;
+    /** Variante visual do card: 1 ou 2 */
     variant?: 1 | 2;
+    /** Lista de itens de mídia para exibir nos cards */
     items: CardMediaProps[];
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
 }

package/dist/components/core/carousel/grid/profile/types.d.ts

@@ -1,11 +1,21 @@
 import type { CardProfileProps } from "../../../card/types";
 import type { CarouselSlotProps } from "../../../panel/type";
 import type { CarouselHeaderProps } from "../../types";
+/**
+ * Props do CarouselGridProfile — layout em grid de cards de perfil
+ * (guias, intérpretes, organizações). Em mobile vira carousel com swipe.
+ */
 export interface CarouselProfileProps {
+    /** Props do cabeçalho do carousel (título, descrição, etc.) */
     headerProps?: CarouselHeaderProps;
+    /** Props do slot/container do carousel (botões navegação, plugins) */
     slotProps?: CarouselSlotProps;
+    /** Classe CSS adicional para o container do grid */
     gridClass?: string;
+    /** Variante visual do card: 1 ou 2 */
     variant?: 1 | 2;
+    /** Lista de perfis para exibir nos cards */
     items: CardProfileProps[];
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
 }

package/dist/components/core/carousel/highlights/types.d.ts

@@ -1,12 +1,23 @@
 import type { CardHighlightProps } from "../../card/types";
 import type { CarouselSlotProps } from "../../panel/type";
 import type { CarouselHeaderProps } from "../types";
+/**
+ * Props do CarouselHighlights — carousel de cards de destaque
+ * (organizações, serviços em evidência).
+ */
 export interface CarouselHighlightsProps {
+    /** Props do cabeçalho do carousel (título, descrição, etc.) */
     headerProps?: CarouselHeaderProps;
+    /** Props do slot/container do carousel (botões navegação, plugins) */
     slotProps?: CarouselSlotProps;
+    /** Lista de itens de destaque */
     items: CardHighlightProps[];
+    /** Variante visual do card: 1 ou 2 */
     varient?: 1 | 2;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Exibe ícone antes da descrição do card */
     isDescriptionIcon?: boolean;
+    /** Exibe etiqueta (label) na descrição do card */
     isDescriptionLabel?: boolean;
 }

package/dist/components/core/carousel/promotion/types.d.ts

@@ -1,11 +1,21 @@
 import type { CardPromotionProps } from "../../card/types";
 import type { CarouselSlotProps } from "../../panel/type";
 import type { CarouselHeaderProps } from "../types";
+/**
+ * Props do CarouselPromotion — carousel de cards de promoção
+ * com preços antigo/novo e botões de compra.
+ */
 export interface CarouselPromotionProps {
+    /** Props do cabeçalho do carousel (título, descrição, etc.) */
     headerProps?: CarouselHeaderProps;
+    /** Props do slot/container do carousel (botões navegação, plugins) */
     slotProps?: CarouselSlotProps;
+    /** Lista de promoções para exibir */
     items: CardPromotionProps[];
+    /** Exibe ícone antes da descrição do card */
     isDescriptionIcon?: boolean;
+    /** Exibe etiqueta (label) na descrição do card */
     isDescriptionLabel?: boolean;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
 }

package/dist/components/core/carousel/types.d.ts

@@ -1,48 +1,104 @@
 import type { IconSvgElement } from "@hugeicons/svelte";
 import type { NavMenuProps } from "../nav/data/nav-menu";
+/**
+ * Item individual do CarouselBadge — categoria/opção com ícone,
+ * imagem, label e callback de clique.
+ */
 export interface ItemCarousel {
+    /** Valor único do item (usado para identificar seleção) */
     value: string;
+    /** Texto exibido no item */
     label: string;
+    /** URL da imagem opcional do item */
     image?: string;
+    /** URL de navegação opcional */
     link?: string;
+    /** Ícone SVG opcional do item */
     icon?: IconSvgElement | string;
+    /** Indica se o item está ativo/selecionado */
     isActive?: boolean;
+    /** Callback acionado ao clicar no item */
     onClick?: (value: string) => void;
 }
+/**
+ * Props do CarouselHeader — cabeçalho de carousel com título,
+ * descrição e botão "Ver tudo".
+ */
 export interface CarouselHeaderProps {
+    /** Título do carousel */
     title?: string;
+    /** Descrição/subtítulo abaixo do título */
     description?: string;
+    /** Classe CSS personalizada para o título */
     titleClass?: string;
+    /** Classe CSS personalizada para a descrição */
     descriptionClass?: string;
+    /** Classe CSS adicional para o container do header */
     containerClass?: string;
+    /** Callback ao clicar no botão "Ver tudo" */
     onButtonViewAll?: () => void;
+    /** Posição dos botões anterior/próximo */
     positionButtonPreviousAndNext?: "center" | "top_right";
+    /** Exibe borda inferior no header */
     isBorder?: boolean;
 }
+/**
+ * Props do CarouselBadge — carousel de badges/categorias
+ * com orientação horizontal ou vertical.
+ */
 export interface CarouselBadgeProps {
+    /** Lista de itens do carousel de badges */
     items: ItemCarousel[];
+    /** Orientação do layout: horizontal (padrão) ou vertical */
     orientation?: "horizontal" | "vertical";
+    /** Classe CSS personalizada para a imagem */
     imageClass?: string;
+    /** Classe CSS personalizada para o ícone */
     iconClass?: string;
+    /** Classe CSS personalizada para o label */
     labelClass?: string;
+    /** Classe CSS personalizada para o estado ativo */
     activeClass?: string;
+    /** Valor do item ativo por padrão */
     valueActive?: string;
+    /** Estado de carregamento (skeleton) */
     isLoading?: boolean;
+    /** Exibe borda em cada item */
     isBorderItem?: boolean;
+    /** Exibe borda inferior no container */
     isBorderBottom?: boolean;
+    /** Classe CSS adicional para cada item do carousel */
     itemCarouselClass?: string;
+    /** Exibe botões anterior/próximo */
     isButtonPreviousAndNext?: boolean;
+    /** Classe CSS personalizada para botões anterior/próximo */
     buttonPreviousAndNextClass?: string;
 }
+/**
+ * Item individual do CarouselHero — slide com imagem,
+ * título e descrição.
+ */
 export interface CarouselHeroItem {
+    /** Título do slide hero */
     title: string;
+    /** URL da imagem de fundo do slide */
     image: string;
+    /** Descrição do slide */
     description: string;
 }
+/**
+ * Props do CarouselHero — carousel hero principal (ex: página de login)
+ * com slides em fullscreen e menu de navegação sobreposto.
+ */
 export interface CarouselHeroProps {
+    /** Lista de slides do hero */
     items: CarouselHeroItem[];
+    /** Configuração do menu de navegação sobreposto */
     navMenu: NavMenuProps;
+    /** Classe CSS adicional para o container */
     className?: string;
+    /** Classe CSS personalizada para o título */
     titleClass?: string;
+    /** Classe CSS personalizada para a descrição */
     descriptionClass?: string;
 }

package/dist/components/core/datatable/data/data-table.d.ts

@@ -1,19 +1,44 @@
 import type { CellContext, HeaderContext } from "@tanstack/table-core";
 import type { Component } from "svelte";
+/**
+ * Definição completa de uma tabela de dados genérica.
+ * Usada pelo DataTableCore para renderizar colunas, cabeçalhos,
+ * células, badges, ações por linha e filtros.
+ *
+ * @template T Tipo genérico dos itens/linhas da tabela.
+ */
 export interface DataTableItem<T = unknown> {
+    /** Definição das colunas da tabela */
     config: {
+        /** Chave de acesso ao valor na linha (ex: "name", "email") */
         accessorKey: string;
+        /** Cabeçalho da coluna: string estática ou função que renderiza componente customizado */
         header: string | ((context: HeaderContext<T, unknown>) => any);
+        /** Conteúdo da célula: string (valor simples) ou função que renderiza componente customizado */
         cell: string | ((context: CellContext<T, unknown>) => any);
+        /** Habilita/desabilita ordenação nesta coluna */
         enableSorting?: boolean;
+        /** Habilita/desabilita ocultação da coluna */
         enableHiding?: boolean;
+        /** Configuração opcional de badges (etiquetas coloridas) renderizadas na célula */
         badge?: {
+            /** Classe CSS adicional para o badge */
             className?: string;
+            /** Valor que ativa este badge (comparado com o valor da célula) */
             value: string;
+            /** Label exibida no badge (se omitido, usa o próprio valor) */
             label?: string;
         }[];
     }[];
+    /** Chave da coluna usada para o filtro de pesquisa global/list filter */
     columnFilter?: keyof T & string;
+    /** Componente Svelte renderizado na coluna de ações de cada linha */
     actions?: Component<any>;
+    /** Array de itens/linhas para popular a tabela */
     items?: T[];
 }
+/**
+ * Alias de DataTableItem<T> — props do componente DataTableCore.
+ * @template T Tipo genérico dos itens/linhas.
+ */
+export type DataTableCoreProps<T = unknown> = DataTableItem<T>;

package/dist/components/core/footer/types.d.ts

@@ -1,23 +1,51 @@
+/**
+ * Item de link individual exibido numa coluna do footer.
+ */
 export interface FooterLinkItem {
+    /** Texto exibido no link */
     text: string;
+    /** URL de destino (href) */
     href?: string;
 }
+/**
+ * Item de rede social do footer com ícone, texto e link.
+ */
 export interface FooterSocialItem {
+    /** Ícone da rede social — nome do ícone pré-definido */
     icon: "facebook" | "instagram" | "x" | "github" | "youtube" | "linkedin";
+    /** Texto usado como aria-label / tooltip */
     text: string;
+    /** URL do perfil/rede social */
     href?: string;
 }
+/**
+ * Coluna do footer com título e lista de links.
+ */
 export interface FooterColumnProps {
+    /** Título da coluna (ex: "Empresa", "Recursos") */
     title: string;
+    /** Lista de links dentro da coluna */
     items: FooterLinkItem[];
 }
+/**
+ * Props do componente Footer — rodapé completo com múltiplas colunas,
+ * logo, newsletter opcional e ícones de redes sociais.
+ */
 export interface FooterProps {
+    /** Lista de colunas de navegação do rodapé */
     items: FooterColumnProps[];
+    /** URL do logotipo da empresa */
     logo?: string;
+    /** Habilita/desabilita o formulário de newsletter */
     isNewsletter?: boolean;
+    /** Lista de ícones das redes sociais */
     socialsMedia: FooterSocialItem[];
+    /** Nome da empresa (exibido no copyright e newsletter) */
     companyName?: string;
+    /** Título da seção de newsletter */
     newsletterTitle?: string;
+    /** Descrição/texto auxiliar da newsletter */
     newsletterDescription?: string;
+    /** Callback acionado ao submeter o email da newsletter */
     onSubscribe?: (email: string) => void;
 }

package/dist/components/core/nav/data/nav-menu-sidebar.d.ts

@@ -1,21 +1,50 @@
 import type { IconSvgElement } from "@hugeicons/svelte";
+/**
+ * Grupo/categoria de menus na sidebar (ex: "Gestão", "Relatórios").
+ */
 export interface GroupMenuSidebarProps {
+    /** Nome/título do grupo de menus */
     name: string;
 }
+/**
+ * Submenu de um item principal da sidebar.
+ */
 export interface SubMenuSidebarProps {
+    /** Título do submenu */
     title: string;
+    /** URL de destino do submenu */
     url: string;
+    /** Ícone SVG do submenu */
     icon: IconSvgElement;
+    /** Indica se o submenu está ativo/selecionado */
     isActive?: boolean;
 }
+/**
+ * Item de menu principal da sidebar.
+ * Pode ser um item simples ou ter submenus.
+ */
 export interface NavMenuSidebarProps {
+    /** Título/nome do item de menu */
     title: string;
+    /** URL de destino (se não tiver submenus) */
     url?: string;
+    /** Ícone SVG do item de menu */
     icon: IconSvgElement;
+    /** Indica se o item está ativo/selecionado */
     isActive?: boolean;
+    /** Grupo/categoria a que o menu pertence */
     group?: GroupMenuSidebarProps;
 }
+/**
+ * Item de menu com submenus aninhados.
+ * Estende NavMenuSidebarProps adicionando suporte a submenus.
+ */
 export interface NavMenuAndSubmenuSidebarProps extends NavMenuSidebarProps {
+    /** Lista de submenus abaixo do item principal */
     submenus?: SubMenuSidebarProps[];
 }
+/**
+ * Tipo união para itens da barra lateral — pode ser
+ * um item simples ou um item com submenus.
+ */
 export type NavMenuItem = NavMenuSidebarProps | NavMenuAndSubmenuSidebarProps;

package/dist/components/core/nav/data/nav-menu.d.ts

@@ -1,36 +1,79 @@
 import type { IconSvgElement } from "@hugeicons/svelte";
+/**
+ * Props do logotipo no NavMenu.
+ */
 export interface NavMenuLogoProps {
+    /** URL da imagem do logotipo */
     img?: string;
+    /** URL de destino ao clicar no logo */
     url?: string;
+    /** Texto alternativo / label do logo */
     label: string;
+    /** Classe CSS adicional */
     className?: string;
+    /** Callback ao clicar no logo */
     onclick?: () => void;
 }
+/**
+ * Props de um link individual no menu de navegação.
+ */
 export interface NavMenuLinksProps {
+    /** URL de destino do link */
     url?: string;
+    /** Alias de `url` — URL de destino do link (compatibilidade) */
+    href?: string;
+    /** Texto exibido no link */
     label: string;
+    /** Ícone SVG opcional antes do label */
     icon?: IconSvgElement;
+    /** Callback ao clicar no link */
     onclick?: () => void;
 }
+/**
+ * Props de um item de ação (botão ou link) no menu de navegação.
+ * Usado para login, registo, etc.
+ */
 export interface NavMenuActionsProps {
+    /** URL de destino da ação */
     url?: string;
+    /** Texto exibido na ação */
     label: string;
+    /** Tipo de elemento: botão estilizado ou link simples */
     type?: 'BUTTON' | 'LINK';
+    /** Classe CSS adicional */
     className?: string;
+    /** Ícone SVG opcional */
     icon?: IconSvgElement;
+    /** Callback ao clicar na ação */
     onclick?: () => void;
 }
+/**
+ * Props do componente NavMenu — barra de navegação principal
+ * com logo, links, ações (login/registo), language switcher e light switch.
+ */
 export interface NavMenuProps {
+    /** Classe CSS adicional para o container do nav */
     navClass?: string;
+    /** Classe CSS personalizada para cada link */
     linkClass?: string;
+    /** Classe CSS personalizada para o grupo de links/açōes */
     groupClass?: string;
+    /** Classe CSS personalizada para os botões */
     buttonClass?: string;
+    /** Configuração do logotipo */
     logo?: NavMenuLogoProps;
+    /** Lista de links de navegação */
     links: NavMenuLinksProps[];
+    /** Lista de ações (ex: Login, Registar) */
     actions?: NavMenuActionsProps[];
+    /** Alinhamento dos links e das ações */
     align?: 'LINK_SEPARATED_ACTIONS' | 'LINK_INTO_ACTIONS';
+    /** Exibe o interruptor de tema (claro/escuro) */
     isLightSwitch?: boolean;
+    /** Exibe o seletor de idioma */
     isLanguageSwitcher?: boolean;
+    /** Callback ao clicar no botão Login */
     onclickButtonLogin?: () => void;
+    /** Callback ao clicar no botão Registar */
     onclickButtonRegister?: () => void;
 }