negodesign 0.0.69 → 0.0.70

package/dist/globals.css

@@ -555,6 +555,9 @@
   .mt-5 {
     margin-top: calc(var(--spacing) * 5);
   }
+  .mt-6 {
+    margin-top: calc(var(--spacing) * 6);
+  }
   .mt-7 {
     margin-top: calc(var(--spacing) * 7);
   }
@@ -564,6 +567,9 @@
   .mt-12 {
     margin-top: calc(var(--spacing) * 12);
   }
+  .mt-16 {
+    margin-top: calc(var(--spacing) * 16);
+  }
   .mt-auto {
     margin-top: auto;
   }
@@ -753,6 +759,10 @@
     width: calc(var(--spacing) * 24);
     height: calc(var(--spacing) * 24);
   }
+  .size-256 {
+    width: calc(var(--spacing) * 256);
+    height: calc(var(--spacing) * 256);
+  }
   .size-full {
     width: 100%;
     height: 100%;
@@ -850,6 +860,9 @@
   .h-75 {
     height: calc(var(--spacing) * 75);
   }
+  .h-80 {
+    height: calc(var(--spacing) * 80);
+  }
   .h-\[65px\] {
     height: 65px;
   }
@@ -1030,6 +1043,9 @@
   .w-144\.25 {
     width: calc(var(--spacing) * 144.25);
   }
+  .w-228 {
+    width: calc(var(--spacing) * 228);
+  }
   .w-\[15px\] {
     width: 15px;
   }
@@ -1096,6 +1112,9 @@
   .max-w-md {
     max-width: var(--container-md);
   }
+  .max-w-none {
+    max-width: none;
+  }
   .max-w-sm {
     max-width: var(--container-sm);
   }
@@ -1906,6 +1925,9 @@
   .bg-red-500 {
     background-color: var(--color-red-500);
   }
+  .bg-red-600 {
+    background-color: var(--color-red-600);
+  }
   .bg-red-900\/50 {
     background-color: color-mix(in srgb, oklch(39.6% 0.141 25.723) 50%, transparent);
     @supports (color: color-mix(in lab, red, red)) {
@@ -1930,6 +1952,12 @@
   .bg-white {
     background-color: var(--color-white);
   }
+  .bg-white\/5 {
+    background-color: color-mix(in srgb, #fff 5%, transparent);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--color-white) 5%, transparent);
+    }
+  }
   .bg-white\/10 {
     background-color: color-mix(in srgb, #fff 10%, transparent);
     @supports (color: color-mix(in lab, red, red)) {
@@ -2010,6 +2038,9 @@
     --tw-gradient-to: var(--muted);
     --tw-gradient-stops: var(--tw-gradient-via-stops, var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position));
   }
+  .mask-\[radial-gradient\(closest-side\,white\,transparent\)\] {
+    mask-image: radial-gradient(closest-side,white,transparent);
+  }
   .bg-clip-padding {
     background-clip: padding-box;
   }
@@ -2145,6 +2176,9 @@
   .py-12 {
     padding-block: calc(var(--spacing) * 12);
   }
+  .py-24 {
+    padding-block: calc(var(--spacing) * 24);
+  }
   .ps-4 {
     padding-inline-start: calc(var(--spacing) * 4);
   }
@@ -2169,6 +2203,9 @@
   .pt-8 {
     padding-top: calc(var(--spacing) * 8);
   }
+  .pt-16 {
+    padding-top: calc(var(--spacing) * 16);
+  }
   .pr-2 {
     padding-right: calc(var(--spacing) * 2);
   }
@@ -2264,6 +2301,10 @@
     font-size: var(--text-lg);
     line-height: var(--tw-leading, var(--text-lg--line-height));
   }
+  .text-lg\/8 {
+    font-size: var(--text-lg);
+    line-height: calc(var(--spacing) * 8);
+  }
   .text-sm {
     font-size: var(--text-sm);
     line-height: var(--tw-leading, var(--text-sm--line-height));
@@ -2364,6 +2405,9 @@
   .text-balance {
     text-wrap: balance;
   }
+  .text-pretty {
+    text-wrap: pretty;
+  }
   .wrap-break-word {
     overflow-wrap: break-word;
   }
@@ -2433,12 +2477,18 @@
   .text-gray-200 {
     color: var(--color-gray-200);
   }
+  .text-gray-300 {
+    color: var(--color-gray-300);
+  }
   .text-gray-400 {
     color: var(--color-gray-400);
   }
   .text-gray-800 {
     color: var(--color-gray-800);
   }
+  .text-gray-900 {
+    color: var(--color-gray-900);
+  }
   .text-green-500 {
     color: var(--color-green-500);
   }
@@ -2641,6 +2691,12 @@
   .ring-sidebar-ring {
     --tw-ring-color: var(--sidebar-ring);
   }
+  .ring-white\/10 {
+    --tw-ring-color: color-mix(in srgb, #fff 10%, transparent);
+    @supports (color: color-mix(in lab, red, red)) {
+      --tw-ring-color: color-mix(in oklab, var(--color-white) 10%, transparent);
+    }
+  }
   .ring-white\/30 {
     --tw-ring-color: color-mix(in srgb, #fff 30%, transparent);
     @supports (color: color-mix(in lab, red, red)) {
@@ -3444,6 +3500,9 @@
     .hover\:text-foreground:hover {
       color: var(--foreground);
     }
+    .hover\:text-gray-100:hover {
+      color: var(--color-gray-100);
+    }
     .hover\:text-muted-foreground:hover {
       color: var(--muted-foreground);
     }
@@ -4183,6 +4242,12 @@
     .sm\:right-6 {
       right: calc(var(--spacing) * 6);
     }
+    .sm\:left-full {
+      left: 100%;
+    }
+    .sm\:-ml-80 {
+      margin-left: calc(var(--spacing) * -80);
+    }
     .sm\:flex {
       display: flex;
     }
@@ -4213,6 +4278,9 @@
     .sm\:gap-2\.5 {
       gap: calc(var(--spacing) * 2.5);
     }
+    .sm\:rounded-3xl {
+      border-radius: calc(var(--radius) * 2.2);
+    }
     .sm\:px-3\.5 {
       padding-inline: calc(var(--spacing) * 3.5);
     }
@@ -4222,12 +4290,18 @@
     .sm\:px-10 {
       padding-inline: calc(var(--spacing) * 10);
     }
+    .sm\:px-16 {
+      padding-inline: calc(var(--spacing) * 16);
+    }
     .sm\:py-12 {
       padding-block: calc(var(--spacing) * 12);
     }
     .sm\:py-14 {
       padding-block: calc(var(--spacing) * 14);
     }
+    .sm\:py-32 {
+      padding-block: calc(var(--spacing) * 32);
+    }
     .sm\:text-2xl {
       font-size: var(--text-2xl);
       line-height: var(--tw-leading, var(--text-2xl--line-height));
@@ -4473,6 +4547,9 @@
     .md\:pt-10 {
       padding-top: calc(var(--spacing) * 10);
     }
+    .md\:pt-24 {
+      padding-top: calc(var(--spacing) * 24);
+    }
     .md\:pb-10 {
       padding-bottom: calc(var(--spacing) * 10);
     }
@@ -4568,12 +4645,27 @@
     .lg\:-bottom-3 {
       bottom: calc(var(--spacing) * -3);
     }
+    .lg\:left-1\/2 {
+      left: calc(1 / 2 * 100%);
+    }
+    .lg\:mx-0 {
+      margin-inline: 0px;
+    }
     .lg\:mt-5 {
       margin-top: calc(var(--spacing) * 5);
     }
+    .lg\:mt-8 {
+      margin-top: calc(var(--spacing) * 8);
+    }
+    .lg\:ml-0 {
+      margin-left: 0px;
+    }
     .lg\:block {
       display: block;
     }
+    .lg\:flex {
+      display: flex;
+    }
     .lg\:h-20 {
       height: calc(var(--spacing) * 20);
     }
@@ -4622,6 +4714,17 @@
     .lg\:min-w-150 {
       min-width: calc(var(--spacing) * 150);
     }
+    .lg\:flex-auto {
+      flex: auto;
+    }
+    .lg\:-translate-x-1\/2 {
+      --tw-translate-x: calc(calc(1 / 2 * 100%) * -1);
+      translate: var(--tw-translate-x) var(--tw-translate-y);
+    }
+    .lg\:translate-y-0 {
+      --tw-translate-y: 0px;
+      translate: var(--tw-translate-x) var(--tw-translate-y);
+    }
     .lg\:grid-cols-2 {
       grid-template-columns: repeat(2, minmax(0, 1fr));
     }
@@ -4637,24 +4740,42 @@
     .lg\:grid-cols-\[1fr_26rem\] {
       grid-template-columns: 1fr 26rem;
     }
+    .lg\:justify-start {
+      justify-content: flex-start;
+    }
     .lg\:gap-10 {
       gap: calc(var(--spacing) * 10);
     }
     .lg\:gap-15 {
       gap: calc(var(--spacing) * 15);
     }
+    .lg\:gap-x-20 {
+      column-gap: calc(var(--spacing) * 20);
+    }
     .lg\:self-start {
       align-self: flex-start;
     }
     .lg\:px-8 {
       padding-inline: calc(var(--spacing) * 8);
     }
+    .lg\:px-24 {
+      padding-inline: calc(var(--spacing) * 24);
+    }
+    .lg\:py-32 {
+      padding-block: calc(var(--spacing) * 32);
+    }
+    .lg\:pt-0 {
+      padding-top: 0px;
+    }
     .lg\:pt-20 {
       padding-top: calc(var(--spacing) * 20);
     }
     .lg\:pl-12 {
       padding-left: calc(var(--spacing) * 12);
     }
+    .lg\:text-left {
+      text-align: left;
+    }
     .lg\:text-\[80px\] {
       font-size: 80px;
     }

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import AdminContent from "./components/pages/admin/01/ui/AdminContent.svelte";
 import AdminPanel from "./components/pages/admin/01/ui/AdminPanel.svelte";
 import AdCardBanner from "./components/core/banner/AdCardBanner.svelte";
 import CtaCardBanner from "./components/core/banner/CtaCardBanner.svelte";
+import CtaCardImageBanner from "./components/core/banner/CtaCardImageBanner.svelte";
 import NotificationBanner from "./components/core/banner/NotificationBanner.svelte";
 import PrivacyPolicyOrTermsOfUse from "./components/pages/privacy-policy-or-terms-of-use/PrivacyPolicyOrTermsOfUse.svelte";
 import ProductDetails from "./components/pages/product-details/ProductDetails.svelte";
@@ -46,7 +47,41 @@ export { t } from "./i18n";
 export { getMergedTranslations } from "./i18n/config";
 /** Retorna a lista de idiomas disponíveis. */
 export { getLocales } from "./i18n/config";
-export { Menu, ItemsSimpleGrid, ItemsPanel, 
+export { 
+/**
+ * Barra de navegação responsiva que alterna entre as variantes Simples
+ * (links) e Complexa (menus) consoante o dispositivo (mobile ou desktop).
+ * Inclui logo, botões de ação, light switch e language switcher.
+ * @property {NavMenuLogoProps} logo - Logotipo do menu
+ * @property {MenuVarientProps} navMenu - Variante de navegação (Simples ou Complexa)
+ * @property {NavMenuButtonProps} navMenuButton - Botão de ação (login/registo)
+ * @property {boolean} isBorder - Exibe borda inferior no menu
+ * @property {boolean} isLightSwitch - Exibe o interruptor de tema (claro/escuro)
+ * @property {boolean} isLanguageSwitcher - Exibe o seletor de idioma
+ * @see MenuProps
+ */
+Menu, 
+/**
+ * Grid de itens (cards) com variantes visuais 1 e 2.
+ * Em mobile vira uma lista de scroll horizontal; em desktop usa colunas
+ * dinâmicas baseadas no número de itens. Suporta estado de carregamento.
+ * @property {ItemGridProps[]} items - Lista de itens a exibir
+ * @property {1|2} variant - Variante visual dos cards (padrão: 1)
+ * @property {boolean} isLoading - Exibe skeletons de carregamento
+ * @property {(id) => void} onClick - Callback ao clicar num item
+ * @property {string} className - Classe CSS adicional do container
+ * @see GridProps
+ */
+ItemsSimpleGrid, 
+/**
+ * Contentor de itens que pode renderizar numa grade (grid) ou num carousel
+ * (inline) com seleção ativa. Cada clique normaliza o id e dispara `onClick`.
+ * @property {ItemGridProps[]} items - Lista de itens a exibir
+ * @property {"grid"|"inline"} style - Estilo de exibição (padrão: "grid")
+ * @property {(id) => void} onClick - Callback ao selecionar um item
+ * @see GridProps
+ */
+ItemsPanel, 
 /**
  * Componente raiz do Negodesign.
  * Configura o tema, idioma e traduções da aplicação.
@@ -55,138 +90,227 @@ export { Menu, ItemsSimpleGrid, ItemsPanel,
  */
 NegoDesign, 
 /**
- * Banner de anúncio com faixa lateral colorida, título destacado e botão CTA.
- * Ideal para publicidade, chamadas de atenção ou ofertas especiais.
+ * Banner de anúncio com faixa lateral colorida, título destacado (duas cores)
+ * e botão CTA. Ideal para publicidade, chamadas de atenção ou ofertas especiais.
+ * @property {string} tagText - Texto da faixa lateral colorida
+ * @property {string} titleHighlight - Primeira parte do título (cor âmbar)
+ * @property {string} titleMain - Segunda parte do título (cor verde)
+ * @property {string} buttonText - Texto do botão CTA
+ * @property {() => void} onClickButton - Chamado ao clicar no CTA
+ * @property {string} href - Link que torna todo o card clicável
  * @see AdCardBannerProps
  */
 AdCardBanner, 
 /**
  * Banner CTA "Vamos entrar em contacto" com título bold, descrição de apoio
  * e até 2 botões em formato de pílula com decoração de anéis concêntricos.
+ * @property {string} title - Título principal do banner
+ * @property {string} description - Texto de apoio/descrição
+ * @property {string} primaryText - Texto do botão primário
+ * @property {string} secondaryText - Texto do botão secundário
+ * @property {() => void} onClickPrimary - Callback do botão primário
+ * @property {() => void} onClickSecondary - Callback do botão secundário
+ * @property {string} primaryHref - Link do botão primário
+ * @property {string} secondaryHref - Link do botão secundário
  * @see CtaCardBannerProps
  */
 CtaCardBanner, 
+/**
+ * Banner CTA com imagem de destaque em fundo gradiente (`bg-gradient`).
+ * Título, descrição e até dois CTAs, cada um com link e/ou callback de clique,
+ * além da imagem e seus atributos.
+ * @property {string} title - Título principal do banner
+ * @property {string} description - Texto de apoio/descrição
+ * @property {string} primaryText - Texto do CTA primário
+ * @property {string} primaryHref - Link do CTA primário
+ * @property {() => void} onClickPrimary - Callback do CTA primário
+ * @property {string} secondaryText - Texto do CTA secundário
+ * @property {string} secondaryHref - Link do CTA secundário
+ * @property {() => void} onClickSecondary - Callback do CTA secundário
+ * @property {string} imageSrc - URL da imagem de destaque
+ * @property {string} imageAlt - Texto alternativo da imagem
+ * @property {number} imageWidth - Largura da imagem
+ * @property {number} imageHeight - Altura da imagem
+ * @see CtaCardImageBannerProps
+ */
+CtaCardImageBanner, 
 /**
  * Banner de notificação com texto em destaque, descrição, CTA e botão dismiss.
  * Usado para comunicar novidades, promoções ou mensagens importantes.
+ * @property {string} strongText - Texto em destaque antes do separador
+ * @property {string} description - Descrição principal
+ * @property {string} ctaText - Texto do botão CTA
+ * @property {string} ctaHref - Link do botão CTA
+ * @property {() => void} onCtaClick - Chamado ao clicar no CTA
+ * @property {() => void} onDismiss - Chamado ao clicar no dismiss
  * @see NotificationBannerProps
  */
 NotificationBanner, 
-/** @see NotFoundEmpty */
+/**
+ * Estado vazio (empty state) com ícone, título, descrição e uma ação
+ * (link ou botão) para quando não há conteúdo a exibir.
+ * @property {string} title - Título do estado vazio
+ * @property {string} description - Descrição de apoio
+ * @property {IconSvgElement} icon - Ícone exibido na área de media
+ * @property {string} actionHref - URL de destino da ação (link)
+ * @property {string} actionLabel - Texto da ação
+ * @property {() => void} onAction - Callback ao clicar na ação (botão)
+ * @property {boolean} showAction - Exibe a ação de suporte
+ * @property {Snippet} children - Conteúdo customizado no lugar da ação padrão
+ * @see NotFoundEmptyProps
+ */
 NotFoundEmpty, 
 /**
  * Campo de input de busca com 2 variantes visuais (borda completa ou underline).
  * Inclui botão de submissão e callback onSubmit.
+ * @property {1|2} variant - Variante visual (1: borda completa, 2: underline)
+ * @property {(value) => void} onSubmit - Chamado ao submeter a busca
  * @see SearchInputProps
  */
 SearchInput, 
 /**
- * CompanyProfile de perfil empresa.
+ * Página de perfil da empresa com informações detalhadas, descrição,
+ * galeria, localização e contactos.
  * @see CompanyProfileProps
  */
 CompanyProfile, 
 /**
  * Carousel de badges/categorias com orientação horizontal ou vertical.
  * Cada item pode ter ícone, imagem, label e callback de clique.
+ * @property {ItemCarousel[]} items - Lista de itens/categorias
+ * @property {boolean} isVertical - Orientação vertical
+ * @property {(item) => void} onClick - Callback ao clicar num item
  * @see CarouselBadgeProps
  */
 CarouselBadge, 
 /**
  * Carousel hero em fullscreen com slides de imagem, título, descrição
  * e menu de navegação sobreposto. Ideal para páginas de login.
+ * @property {CarouselHeroItem[]} items - Lista de slides
  * @see CarouselHeroProps
  */
 CarouselHero, 
 /**
  * Rodapé completo com múltiplas colunas de links, logo, ícones de redes sociais
  * e formulário de newsletter opcional.
+ * @property {FooterColumnProps[]} columns - Colunas de links do rodapé
+ * @property {FooterSocialItem[]} social - Redes sociais
+ * @property {boolean} hasNewsletter - Exibe o formulário de newsletter
  * @see FooterProps
  */
 Footer, 
 /**
  * Carousel de cards de promoção com preços antigo/novo, botão de comprar,
  * favoritar e adicionar ao carrinho.
+ * @property {CardPromotionProps[]} items - Cards de promoção
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
  * @see CarouselPromotionProps
  */
 CarouselPromotion, 
 /**
  * Carousel de cards de destaque para organizações, serviços ou locais em evidência.
  * Suporta duas variantes visuais.
+ * @property {CardHighlightProps[]} items - Cards de destaque
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
+ * @property {1|2} variant - Variante visual
  * @see CarouselHighlightsProps
  */
 CarouselHighlights, 
 /**
  * Layout em grid responsivo de cards de mídia (imagens ou vídeos).
  * Em telas mobile transforma-se num carousel com swipe.
- * @see CarouselMediaProps
+ * @property {CardMediaProps[]} items - Cards de mídia
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
+ * @see CarouselGridMediaProps
  */
 CarouselGridMedia, 
 /**
  * Layout em grid responsivo de cards de perfil (guias, intérpretes, organizações).
  * Em telas mobile transforma-se num carousel com swipe.
- * @see CarouselProfileProps
+ * @property {CardProfileProps[]} items - Cards de perfil
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
+ * @see CarouselGridProfileProps
  */
 CarouselGridProfile, 
 /**
  * Layout em grid responsivo de cards de produto (imagens ou vídeos).
  * Em telas mobile transforma-se num carousel com swipe.
- * @see CarouselProductProps
+ * @property {CardProductProps[]} items - Cards de produto
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
+ * @see CarouselGridProductProps
  */
 CarouselGridProduct, 
 /**
-* Layout em grid responsivo de cards de produto in promotion (imagens ou vídeos).
+ * Layout em grid responsivo de cards de produto em promoção (imagens ou vídeos).
  * Em telas mobile transforma-se num carousel com swipe.
- * @see CarouselGridPromotion
+ * @property {CardProductProps[]} items - Cards de produto em promoção
+ * @property {CarouselHeaderProps} header - Cabeçalho do carousel
+ * @see CarouselGridPromotionProps
  */
 CarouselGridPromotion, 
 /**
  * Componente de abas com estilo underline. Troca o conteúdo (Snippet)
  * conforme a aba selecionada.
+ * @property {TabItem[]} items - Lista de abas (valor identificador e label)
+ * @property {Record<string, Snippet>} contents - Snippets de conteúdo por aba
  * @see TabUnderlineProps
  */
 TabUnderline, 
 /**
  * Página de login completa com carousel hero ao fundo e card de autenticação
  * com múltiplas variantes (email, username, telefone) e formulário de registo.
+ * @property {LoginVariant} variant - Variante do formulário de login
+ * @property {LoginRequestDto} initialData - Valores iniciais do formulário
  * @see PageLoginProps
  */
 PageLogin, 
 /**
  * Página de recuperação de senha com hero carousel e card de solicitação
  * de link de recuperação por email.
+ * @property {ForgetPasswordVariant} variant - Variante do formulário
+ * @property {(data) => Promise<void>} onSubmit - Chamado ao submeter
  * @see PageForgetPasswordProps
  */
 PageForgetPassword, 
 /**
  * Página de redefinição de senha com hero carousel e card para introduzir
  * e confirmar a nova palavra-passe.
+ * @property {(data) => Promise<void>} onSubmit - Chamado ao submeter
  * @see PageResetPasswordProps
  */
 PageResetPassword, 
 /**
  * Página de política de privacidade ou termos de utilização com sidebar,
  * tabela de conteúdos e blocos de conteúdo navegáveis.
+ * @property {DocSection[]} sections - Secções de conteúdo do documento
+ * @property {BreadcrumbItem[]} breadcrumb - Navegação breadcrumb
  * @see PrivacyPolicyOrTermsOfUseProps
  */
 PrivacyPolicyOrTermsOfUse, 
 /**
  * Página de detalhes do produto com 4 variantes de layout, galeria de imagens,
  * avaliações, mapa, ficheiros, tabs e painel de compra.
+ * @property {ProductDetailsData} data - Dados completos do produto
+ * @property {1|2|3} variant - Variante de layout
  * @see ProductDetailsProps
  */
 ProductDetails, 
 /**
  * Página de perfil de utilizador com 3 variantes de layout.
  * Inclui informação básica, alterar senha, preferências e experiência.
- * - varient=1: Header colorido com dados admin, tabs e painel de detalhes.
- * - varient=2: Banner com avatar sobreposto, formulário alterar senha (Security).
- * - varient=3: Header roxo com tabs de experiência e timeline.
+ * - variant=1: Header colorido com dados admin, tabs e painel de detalhes.
+ * - variant=2: Banner com avatar sobreposto, formulário alterar senha (Security).
+ * - variant=3: Header roxo com tabs de experiência e timeline.
+ * @property {ProfileUserData} data - Dados do utilizador
+ * @property {ProfileUserVariant} variant - Variante de layout
  * @see ProfileUserProps
  */
 ProfileUser, 
 /**
  * Página de verificação OTP com hero carousel e card de input de código
  * de 6 dígitos para validação de login ou recuperação.
+ * @property {OtpVerificationRequestDto} initialData - Valores iniciais
+ * @property {(data) => Promise<void>} onSubmit - Chamado ao validar o OTP
  * @see PageOtpVerificationProps
  */
 PageOtpVerification, 
@@ -194,13 +318,19 @@ PageOtpVerification,
  * Tabela de dados genérica construída sobre o TanStack Table.
  * Inclui paginação, ordenação, filtros, badges, coluna de seleção,
  * drag handle e ações personalizadas por linha.
- * @template T Tipo genérico dos itens/linhas
+ * @template T - Tipo genérico dos itens/linhas
+ * @property {DataTableItem<T>} item - Definição da tabela (colunas, filtros, ações)
  * @see DataTableCoreProps
  */
 DataTableCore, 
 /**
  * Sidebar de navegação administrativa com menu colapsável, cabeçalho customizável,
  * lista de menus/submenus, botões do rodapé e bloco de utilizador logado.
+ * @property {NavMenuItem[]} menus - Itens de navegação principal (com ou sem submenus)
+ * @property {NavUserSidebarProps} user - Bloco de utilizador logado
+ * @property {NavMenuSidebarProps[]} menusButtons - Botões do rodapé da sidebar (ex: logout)
+ * @property {Snippet} header - Snippet customizado do cabeçalho da sidebar
+ * @property {Snippet} footer - Snippet customizado do rodapé da sidebar
  * @see MenuBarSidebarProps
  */
 MenuBarSidebar, 
@@ -211,12 +341,14 @@ MenuBarSidebar,
  * @property {Snippet} appsidebar - Snippet com a sidebar da aplicação
  * @property {Snippet} content - Snippet com o conteúdo principal
  * @property {Snippet} breadcrumb - Snippet com a navegação breadcrumb
+ * @see AdminPanelProps
  */
 AdminPanel, 
 /**
  * Wrapper de conteúdo para páginas administrativas.
  * Aplica padding, layout flex colunar e gaps consistentes entre secções.
  * @property {Snippet} children - Snippet com o conteúdo interno da página
+ * @see AdminContentProps
  */
 AdminContent, 
 /**
@@ -224,6 +356,8 @@ AdminContent,
  * Suporta two-way binding via prop `value`.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputEmail, 
 /**
@@ -231,6 +365,8 @@ InputEmail,
  * e validação do formato.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputPhone, 
 /**
@@ -238,13 +374,19 @@ InputPhone,
  * Detecta automaticamente o tipo com base no valor introduzido.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputEmailOrPhone, 
 /**
  * Campo de input para código OTP (One-Time Password) com N caixas de dígitos separadas.
  * Suporta separador visual entre grupos de dígitos.
+ * @property {string} value - Valor vinculado do input
+ * @property {string} label - Rótulo personalizado do campo (opcional)
  * @property {number} length - Quantidade de caixas de dígitos (padrão: 6)
  * @property {boolean} separator - Exibir separador visual entre grupos
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputCodeOtp, 
 /**
@@ -252,12 +394,16 @@ InputCodeOtp,
  * Suporta two-way binding e validações customizadas.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputPassword, 
 /**
  * Campo de input para nome de utilizador com ícone e label integrados.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputUsername, 
 /**
@@ -265,5 +411,7 @@ InputUsername,
  * para validar correspondência entre os dois campos.
  * @property {string} value - Valor vinculado do input
  * @property {string} label - Rótulo personalizado do campo
+ * @property {string} placeholder - Texto de exemplo do campo
+ * @see InputLabelProps
  */
 InputPasswordConfirm };