@seniorsistemas/angular-components 19.0.5 → 19.0.7

package/accordion/lib/accordion/accordion.component.d.ts

@@ -1,8 +1,33 @@
 import { AfterContentInit, OnChanges, QueryList, SimpleChanges, OnDestroy } from '@angular/core';
 import { AccordionPanelComponent } from './components/accordion-panel/accordion-panel.component';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de acordeão que gerencia a abertura e o fechamento de painéis
+ * {@link AccordionPanelComponent}. Suporta modo de painel único (apenas um aberto por vez)
+ * ou modo múltiplo (vários painéis abertos simultaneamente), configurável via input `multiple`.
+ *
+ * @example
+ * ```html
+ * <s-accordion [multiple]="false" [activeIndex]="0">
+ *   <s-accordion-panel header="Seção 1">Conteúdo 1</s-accordion-panel>
+ *   <s-accordion-panel header="Seção 2">Conteúdo 2</s-accordion-panel>
+ * </s-accordion>
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class AccordionComponent implements AfterContentInit, OnChanges, OnDestroy {
+    /**
+     * @description Índice (ou lista de índices) do(s) painel(is) que devem iniciar abertos.
+     * Aceita um número para painel único ou um array de números para o modo múltiplo.
+     */
     activeIndex?: number | number[];
+    /**
+     * @description Permite que múltiplos painéis estejam abertos ao mesmo tempo.
+     * Quando `false`, abrir um painel fecha automaticamente o anterior.
+     *
+     * @default false
+     */
     multiple: boolean;
     panelsComponents?: QueryList<AccordionPanelComponent>;
     private readonly _unsubscribe$;

package/accordion/lib/accordion/components/accordion-panel/accordion-panel.component.d.ts

@@ -2,16 +2,76 @@ import { AfterViewInit, EventEmitter, OnChanges, SimpleChanges } from '@angular/
 import { UntypedFormControl } from '@angular/forms';
 import { AccordionButtonSettings, ValidationMessageIconColor } from '../../models/accordion-button-settings';
 import * as i0 from "@angular/core";
+/**
+ * @description Painel individual do {@link AccordionComponent}. Gerencia o estado de
+ * abertura/fechamento com animação, podendo conter um switch de controle via `switchControl`,
+ * botões de ação configuráveis e uma mensagem de validação com ícone.
+ *
+ * @example
+ * ```html
+ * <s-accordion-panel
+ *   header="Configurações"
+ *   [disabled]="false"
+ *   (panelOpened)="onOpen()"
+ *   (panelClosed)="onClose()">
+ *   <p>Conteúdo do painel</p>
+ * </s-accordion-panel>
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class AccordionPanelComponent implements OnChanges, AfterViewInit {
+    /**
+     * @description Título exibido no cabeçalho do painel. Campo obrigatório.
+     */
     header: string;
+    /**
+     * @description Lista de botões de ação exibidos no cabeçalho do painel,
+     * à direita do título. Cada item define ícone, tooltip e callback de clique.
+     */
     buttons?: AccordionButtonSettings[];
+    /**
+     * @description Desabilita a interação do usuário com o painel, impedindo abertura e fechamento.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * @description `FormControl` vinculado a um switch exibido no cabeçalho do painel.
+     * Permite habilitar/desabilitar o conteúdo do painel via toggle.
+     */
     switchControl?: UntypedFormControl;
+    /**
+     * @description Mensagem de validação exibida abaixo do cabeçalho, acompanhada de um ícone.
+     * Útil para indicar erros ou alertas relacionados ao conteúdo do painel.
+     */
     validationMessage?: string;
+    /**
+     * @description Mantém o conteúdo do painel no DOM mesmo quando fechado (modo cache).
+     * Útil para preservar o estado de componentes internos ao reabrir o painel.
+     *
+     * @default false
+     */
     cache: boolean;
+    /**
+     * @description Classe do ícone exibido ao lado da mensagem de validação.
+     *
+     * @default 'fas fa-exclamation-circle'
+     */
     validationMessageIcon: string;
+    /**
+     * @description Cor do ícone da mensagem de validação.
+     *
+     * @default 'Red'
+     */
     validationMessageIconColor: ValidationMessageIconColor;
+    /**
+     * @description Emitido quando o painel é aberto pelo usuário.
+     */
     panelOpened: EventEmitter<void>;
+    /**
+     * @description Emitido quando o painel é fechado pelo usuário.
+     */
     panelClosed: EventEmitter<void>;
     isAnimating: boolean;
     isContentAnimationDisabled: boolean;

package/alert/lib/alert/alert.component.d.ts

@@ -1,10 +1,50 @@
 import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de alerta que exibe mensagens informativas, de sucesso, aviso ou erro.
+ * Suporta fechamento manual pelo usuário e emite um evento ao ser fechado.
+ *
+ * @example
+ * ```html
+ * <s-alert
+ *   severity="warning"
+ *   summary="Atenção"
+ *   detail="Verifique os dados antes de continuar."
+ *   (closed)="onAlertClosed()"
+ * />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class AlertComponent {
+    /**
+     * @description Nível de severidade do alerta, que define a cor e o ícone exibidos.
+     * - `'info'`: alerta informativo (padrão).
+     * - `'success'`: alerta de sucesso.
+     * - `'warning'`: alerta de aviso.
+     * - `'error'`: alerta de erro.
+     *
+     * @default 'info'
+     */
     severity: 'info' | 'success' | 'warning' | 'error';
+    /**
+     * @description Título principal do alerta exibido em destaque. Campo obrigatório.
+     */
     summary: string;
+    /**
+     * @description Mensagem detalhada exibida abaixo do título do alerta. Campo obrigatório.
+     */
     detail: string;
+    /**
+     * @description Quando `true`, exibe o botão de fechar o alerta.
+     * Quando `false`, o alerta não pode ser dispensado pelo usuário.
+     *
+     * @default true
+     */
     closable: boolean;
+    /**
+     * @description Emitido quando o usuário fecha o alerta clicando no botão de fechar.
+     */
     closed: EventEmitter<void>;
     get isOpen(): boolean;
     closeAlert(): void;

package/autocomplete/lib/autocomplete/autocomplete.component.d.ts

@@ -13,39 +13,90 @@ interface SuggestionWrapper<T> {
     id: string;
     isSelected?: boolean;
 }
+/**
+ * @description Componente de autocompletar com sugestões dinâmicas, suportando seleção simples
+ * e múltipla. Implementa {@link ControlValueAccessor} para integração com formulários Angular.
+ * Oferece carregamento lazy de sugestões via output `lazyLoad`, virtualização de lista,
+ * seleção com chips no modo múltiplo e acessibilidade ARIA completa (combobox role).
+ *
+ * @example
+ * ```html
+ * <s-autocomplete
+ *   formControlName="cidade"
+ *   placeholder="Buscar cidade..."
+ *   [suggestions]="cidades"
+ *   suggestionLabel="nome"
+ *   [delay]="400"
+ *   (completeMethod)="buscar($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     private static nextId;
+    /** @description Lista estática de sugestões exibidas no dropdown. No modo lazy, prefira usar o output `lazyLoad`. @default [] */
     suggestions: import("@angular/core").InputSignal<T[]>;
+    /** @description Texto exibido no input quando nenhum valor está selecionado. */
     placeholder: import("@angular/core").InputSignal<string | undefined>;
+    /** @description Chave do objeto de sugestão cujo valor será emitido ao formulário. */
     suggestionValue: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Chave do objeto de sugestão usada como texto de exibição no dropdown. */
     suggestionLabel: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Torna o campo somente leitura, impedindo digitação e seleção. @default false */
     readonly: import("@angular/core").InputSignal<boolean>;
+    /** @description Mensagem exibida no dropdown quando nenhuma sugestão é encontrada. */
     emptyMessage: import("@angular/core").InputSignal<string | undefined>;
+    /** @description Tempo de espera em ms após a última tecla antes de acionar a busca por sugestões. @default 300 */
     delay: import("@angular/core").InputSignal<number>;
+    /** @description Exibe estado de erro visual no campo de input. @default false */
     invalid: import("@angular/core").InputSignal<boolean>;
+    /** @description Habilita virtualização da lista de sugestões para melhor performance com grandes volumes de dados. @default false */
     virtualScroll: import("@angular/core").InputSignal<boolean>;
+    /** @description Altura fixa em pixels de cada item no virtual scroll. @default 37 */
     virtualScrollItemSize: import("@angular/core").InputSignal<number>;
+    /** @description Ativa o carregamento assíncrono de sugestões via o output `lazyLoad`. @default false */
     lazy: import("@angular/core").InputSignal<boolean>;
+    /** @description Exibe um botão de dropdown para abrir a lista sem necessidade de digitação. @default false */
     dropdown: import("@angular/core").InputSignal<boolean>;
+    /** @description Quando `true`, o valor do campo deve ser obrigatoriamente uma das opções sugeridas. @default false */
     forceSelection: import("@angular/core").InputSignal<boolean>;
+    /** @description Exibe ícone de checkmark ao lado da opção selecionada no dropdown. @default false */
     checkmark: import("@angular/core").InputSignal<boolean>;
+    /** @description Habilita seleção de múltiplos itens exibidos como chips no campo. @default false */
     multiple: import("@angular/core").InputSignal<boolean>;
+    /** @description Quantidade mínima de caracteres necessária para acionar a busca por sugestões. @default 1 */
     minLengthToSearch: import("@angular/core").InputSignal<number>;
+    /** @description Classe CSS adicional aplicada ao elemento `<input>` interno. @default '' */
     inputClass: import("@angular/core").InputSignal<string>;
+    /** @description Chave do objeto usada para comparação de identidade entre opções, evitando duplicatas na seleção múltipla. */
     dataKey: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Valor atualmente selecionado no modo simples, via two-way binding. */
     value: import("@angular/core").ModelSignal<T | null | undefined>;
+    /** @description Lista de valores selecionados no modo múltiplo, via two-way binding. @default [] */
     values: import("@angular/core").ModelSignal<T[]>;
+    /** @description Controla o estado desabilitado do componente via two-way binding. @default false */
     disabled: import("@angular/core").ModelSignal<boolean>;
+    /**
+     * @description Emitido no modo lazy quando o usuário digita e o componente está pronto para receber novas sugestões.
+     * O evento contém `query` (texto digitado) e `response` (função callback para fornecer os dados).
+     */
     lazyLoad: import("@angular/core").OutputEmitterRef<{
         query: string;
         response: (data: T[]) => void;
     }>;
+    /** @description Emitido quando o usuário seleciona uma sugestão do dropdown. */
     selected: import("@angular/core").OutputEmitterRef<T>;
+    /** @description Emitido quando o usuário remove uma sugestão selecionada (modo múltiplo). */
     unselected: import("@angular/core").OutputEmitterRef<T>;
+    /** @description Emitido quando o campo perde o foco. */
     blurred: import("@angular/core").OutputEmitterRef<Event>;
+    /** @description Emitido quando o campo é limpo pelo usuário. */
     cleared: import("@angular/core").OutputEmitterRef<void>;
+    /** @description Emitido a cada pressionamento de tecla no campo de input. */
     keyUp: import("@angular/core").OutputEmitterRef<Event>;
+    /** @description Emitido quando o campo recebe foco. */
     focused: import("@angular/core").OutputEmitterRef<any>;
+    /** @description Emitido quando o usuário digita no campo, fornecendo o texto atual para filtragem de sugestões. */
     completeMethod: import("@angular/core").OutputEmitterRef<{
         query: string;
     }>;

package/badge/lib/badge/badge.component.d.ts

@@ -2,18 +2,38 @@ import { EventEmitter } from '@angular/core';
 import { BadgeColors } from './types/badge-colors';
 import { BadgeTypes } from './types/badge-types';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de badge (etiqueta) para exibir rótulos coloridos e clicáveis,
+ * com suporte a ícones, variantes visuais (pill, tag) e estado selecionável.
+ *
+ * @example
+ * ```html
+ * <s-badge color="blue" type="pill" text="Ativo" />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class BadgeComponent {
+    /** @description Variante visual do badge. @default 'pill' */
     type?: BadgeTypes;
+    /** @description Cor do badge. @default 'blue' */
     color?: BadgeColors;
+    /** @description Texto de título exibido no badge. */
     title?: string;
+    /** @description Texto principal exibido dentro do badge. */
     text?: string;
+    /** @description Habilita o modo selecionável, emitindo o evento `selected` ao clicar. @default false */
     selectable: boolean;
+    /** @description Classe CSS do ícone exibido no badge (ex.: `'fa fa-check'`). */
     iconClass?: string;
+    /** @description Posição do ícone em relação ao texto. @default 'left' */
     iconPosition?: 'left' | 'right';
+    /** @description Configuração do info-sign exibido no badge, com texto e tempo de exibição opcional. */
     infoSign: {
         text: string;
         displayTime?: number;
     };
+    /** @description Emitido ao clicar no badge, enviando o valor de `text`. */
     selected: EventEmitter<string>;
     onClick(): void;
     enableTruncateText: import("@angular/core").InputSignal<boolean>;

package/bignumber-input/lib/bignumber-input/bignumber-input.directive.d.ts

@@ -10,18 +10,63 @@ export declare enum BignumberAlignmentOption {
     LEFT = "left"
 }
 /**
- * @deprecated Should use BigNumberInput directive instead
+ * @deprecated Utilize a diretiva `BigNumberInput` ao invés desta.
+ * @description Diretiva de máscara para campos de entrada de números de grande precisão,
+ * adaptada do `CurrencyMaskDirective`. Permite configurar precisão, escala,
+ * separadores decimais e de milhar de acordo com o locale da aplicação.
+ *
+ * @example
+ * ```html
+ * <input sBignumberInput [precision]="15" [scale]="2" [allowNegative]="false" />
+ * ```
+ *
+ * @category Inputs
  */
 export declare class BignumberInputDirective extends CurrencyMaskDirective implements OnInit, OnChanges {
     private readonly localeService;
+    /**
+     * @description Número total de dígitos significativos aceitos pelo campo.
+     *
+     * @default 15
+     */
     precision: number;
+    /**
+     * @description Número de casas decimais exibidas e aceitas pelo campo.
+     *
+     * @default 0
+     */
     scale: number;
+    /**
+     * @description Separador decimal personalizado. Quando não informado,
+     * utiliza o separador definido pelo locale ativo da aplicação.
+     */
     decimalSeparator?: string;
+    /**
+     * @description Separador de milhar personalizado. Quando não informado,
+     * utiliza o separador definido pelo locale ativo da aplicação.
+     */
     thousandsSeparator?: string;
+    /**
+     * @description Alinhamento do conteúdo do campo. Aceita `'left'` ou `'right'`.
+     *
+     * @default 'left'
+     */
     alignTo: 'left' | 'right';
+    /**
+     * @description Permite a entrada de valores negativos.
+     *
+     * @default true
+     */
     allowNegative: boolean;
+    /**
+     * @description Texto de placeholder exibido quando o campo está vazio.
+     */
     placeholder?: string;
     maxLength?: number;
+    /**
+     * @description Emitido quando uma colé (paste) é rejeitada pela validação do campo.
+     * Emite a string colada que foi recusada.
+     */
     pasteRejected: EventEmitter<string>;
     private readonly regex;
     constructor(_elementRef: ElementRef, _keyValueDiffers: KeyValueDiffers, localeService: LocaleService);

package/breadcrumb/lib/breadcrumb/breadcrumb.component.d.ts

@@ -1,5 +1,17 @@
 import { BreadcrumbItem } from './breadcrumb-models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de trilha de navegação (breadcrumb) que detecta automaticamente
+ * a rota ativa do Angular Router e constrói o caminho hierárquico de páginas.
+ * Cada segmento da rota precisa ter a propriedade `routeTitle` definida nos `data` da rota.
+ *
+ * @example
+ * ```html
+ * <s-breadcrumb homeUrl="/home" targetHomeUrl="_self" />
+ * ```
+ *
+ * @category Navegação
+ */
 export declare class BreadcrumbListComponent {
     readonly items: import("@angular/core").InputSignal<BreadcrumbItem[]>;
     private readonly router;

package/button/lib/button/button.component.d.ts

@@ -5,28 +5,129 @@ import { ButtonAnimations } from './models/button-animations';
 import { ButtonBadgeConfig } from './models/button-badge-config';
 import { ButtonPriority } from './models/button-priority';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de botão versátil que suporta ícones, tooltip, menu de opções
+ * (tiered menu), badge, animações e diferentes prioridades visuais. Pode ser configurado
+ * como botão de ação simples, botão com menu dropdown ou botão deslizante (slide).
+ *
+ * @example
+ * ```html
+ * <s-button
+ *   label="Salvar"
+ *   iconClass="fas fa-save"
+ *   priority="primary"
+ *   (clicked)="onSave()" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ButtonComponent implements OnChanges {
     minWidth: string;
+    /**
+     * @description Identificador único do elemento botão no DOM.
+     * Gerado automaticamente se não informado.
+     */
     id?: string | undefined;
+    /**
+     * @description Texto exibido dentro do botão.
+     */
     label?: string;
+    /**
+     * @description Texto do tooltip exibido ao passar o mouse sobre o botão.
+     */
     tooltip?: string;
+    /**
+     * @description Posição do tooltip em relação ao botão.
+     *
+     * @default 'top'
+     */
     tooltipPosition: TooltipPositions;
+    /**
+     * @description Classe de ícone exibida à esquerda do label (ex.: `'fas fa-save'`).
+     */
     iconClass?: string;
+    /**
+     * @description Classe de ícone exibida à direita do label.
+     */
     rightIconClass?: string;
+    /**
+     * @description Exibe o ícone de caret (seta) quando o botão possui um menu de opções.
+     *
+     * @default true
+     */
     caret: boolean;
+    /**
+     * @description Classe CSS adicional aplicada ao elemento `<button>` interno.
+     *
+     * @default ''
+     */
     styleClass: string;
+    /**
+     * @description Z-index base do painel do menu dropdown associado ao botão.
+     *
+     * @default 0
+     */
     baseZIndex: number;
+    /**
+     * @description Desabilita o botão, impedindo cliques e interação do usuário.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * @description Aplica estilo auxiliar (menos destaque visual) ao botão.
+     *
+     * @default false
+     */
     auxiliary: boolean;
+    /**
+     * @description Tipo do elemento `<button>` HTML (`'button'`, `'submit'`, `'reset'`).
+     *
+     * @default 'button'
+     */
     type?: string | undefined;
+    /**
+     * @description Prioridade visual do botão, que determina seu estilo.
+     * Aceita `'primary'`, `'default'`, `'danger'`, `'link'`, entre outros.
+     *
+     * @default 'primary'
+     */
     priority?: ButtonPriority;
+    /**
+     * @description Lista de itens do menu dropdown exibido ao clicar no caret do botão.
+     *
+     * @default []
+     */
     menuOptions: TieredMenuItemData[];
+    /**
+     * @description Tamanho visual do botão. Aceita `'default'` ou `'small'`.
+     *
+     * @default 'default'
+     */
     menuAriaLabel?: string;
     size?: 'default' | 'small';
+    /**
+     * @description Habilita o modo slide, que exibe uma animação de deslize ao passar o mouse.
+     * Requer `priority` igual a `'default'` ou `'link'` e um `label` definido.
+     *
+     * @default false
+     */
     slide: boolean;
+    /**
+     * @description Tipo de animação aplicada ao botão (`'rotate'`, `'pulse'`, etc.).
+     */
     animation?: ButtonAnimations;
+    /**
+     * @description Configuração do badge exibido sobre o botão, com contador ou indicador visual.
+     */
     badge?: ButtonBadgeConfig;
+    /**
+     * @description Cor aplicada ao ícone do botão, sobrescrevendo a cor padrão do tema.
+     */
     iconColor?: string;
+    /**
+     * @description Emitido ao clicar no botão, desde que não esteja desabilitado.
+     */
     clicked: EventEmitter<any>;
     validateSlideButton(): boolean;
     ngOnChanges(_: SimpleChanges): void;

package/calendar-mask/lib/calendar-mask/calendar-mask.directive.d.ts

@@ -1,11 +1,35 @@
 import { AfterViewChecked, OnDestroy, OnInit, Renderer2 } from '@angular/core';
 import { Calendar } from 'primeng/calendar';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que aplica máscara de entrada a um componente `p-calendar` do PrimeNG,
+ * formatando automaticamente a data conforme o formato configurado no calendário.
+ * Intercepta os eventos de teclado e input do campo interno do calendar para garantir
+ * que apenas entradas válidas sejam aceitas.
+ *
+ * @example
+ * ```html
+ * <p-calendar sCalendarMask [(ngModel)]="data" dateFormat="dd/mm/yy" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CalendarMaskDirective implements OnInit, OnDestroy, AfterViewChecked {
     host: Calendar;
     renderer: Renderer2;
     SELECTORS: string;
+    /**
+     * @description Caractere usado como placeholder para as posições ainda não preenchidas na máscara.
+     *
+     * @default '_'
+     */
     slotChar: string;
+    /**
+     * @description Quando `true`, limpa automaticamente o campo caso o valor digitado
+     * seja inválido ao perder o foco.
+     *
+     * @default false
+     */
     autoClear: boolean;
     value: any;
     input?: HTMLInputElement;

package/card/lib/card/card.component.d.ts

@@ -1,11 +1,29 @@
 import { AfterContentInit, QueryList, TemplateRef } from '@angular/core';
 import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de cartão com suporte a banner, cabeçalho (título, subtítulo e ícone)
+ * e templates customizáveis para cabeçalho, corpo e rodapé via `TemplateDirective`.
+ *
+ * @example
+ * ```html
+ * <s-card title="Título" subtitle="Subtítulo">
+ *   <ng-template sTemplate type="body">Conteúdo</ng-template>
+ * </s-card>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class CardComponent implements AfterContentInit {
+    /** @description URL da imagem exibida como banner no topo do card. */
     bannerImage?: string;
+    /** @description Faz o card ocupar 100% da largura disponível. @default false */
     fullWidth: boolean;
+    /** @description Título exibido no cabeçalho do card. @default '' */
     title: string;
+    /** @description Subtítulo exibido abaixo do título. @default '' */
     subtitle: string;
+    /** @description Classe do ícone exibido no cabeçalho. @default '' */
     icon: string;
     showBanner: boolean;
     templates?: QueryList<TemplateDirective>;

package/chat/lib/chat/chat.component.d.ts

@@ -1,7 +1,25 @@
-import { AfterViewInit } from "@angular/core";
-import { ChatMessage } from "./types/chat-message";
+import { AfterViewInit } from '@angular/core';
+import { ChatMessage } from './types/chat-message';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de interface de chat que exibe uma lista de mensagens
+ * e faz scroll automático até a última mensagem sempre que novas são adicionadas.
+ * Renderiza cada mensagem via {@link ChatMessageComponent}.
+ *
+ * @example
+ * ```html
+ * <s-chat [messages]="conversaMensagens" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ChatComponent implements AfterViewInit {
+    /**
+     * @description Lista de mensagens exibidas no chat.
+     * Cada item é do tipo {@link ChatMessage}, contendo texto, remetente e demais metadados.
+     *
+     * @default []
+     */
     messages: ChatMessage[];
     private readonly messageElements;
     ngAfterViewInit(): void;

package/chat/lib/chat/components/chat-message/chat-message.component.d.ts

@@ -1,7 +1,23 @@
-import { OnChanges, SimpleChanges } from "@angular/core";
-import { ChatMessage } from "../../types/chat-message";
+import { OnChanges, SimpleChanges } from '@angular/core';
+import { ChatMessage } from '../../types/chat-message';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente que renderiza uma única mensagem de chat.
+ * Exibe o conteúdo textual, o remetente (próprio ou terceiro) e suporte a
+ * anexos via `attachmentUrl`, exibindo o nome do arquivo automaticamente.
+ *
+ * @example
+ * ```html
+ * <s-chat-message [message]="item" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ChatMessageComponent implements OnChanges {
+    /**
+     * @description Objeto com os dados da mensagem a ser exibida,
+     * incluindo texto, remetente e URL de anexo. Campo obrigatório.
+     */
     message: ChatMessage;
     fileName: string | null;
     ngOnChanges(changes: SimpleChanges): void;

package/checkbox/lib/checkbox/checkbox.component.d.ts

@@ -1,20 +1,40 @@
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de caixa de seleção (checkbox) com suporte a três estados:
+ * marcado, desmarcado e indeterminado. Implementa {@link ControlValueAccessor} para
+ * integração com Reactive Forms e Template-driven Forms do Angular.
+ *
+ * @example
+ * ```html
+ * <s-checkbox
+ *   formControlName="aceito"
+ *   label="Aceito os termos de uso"
+ *   [indeterminate]="parcialmenteSelecionado" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CheckboxComponent implements ControlValueAccessor {
+    /** @description Controla o estado desabilitado via two-way binding. @default false */
     disabled: import("@angular/core").ModelSignal<boolean>;
+    /** @description Valor marcado/desmarcado do checkbox via two-way binding. @default false */
     checked: import("@angular/core").ModelSignal<boolean>;
+    /** @description Quando `true`, o checkbox inicia no estado indeterminado (traço) até a primeira interação do usuário. @default false */
     indeterminate: import("@angular/core").InputSignal<boolean>;
+    /** @description Texto do label exibido ao lado do checkbox. @default '' */
     label: import("@angular/core").InputSignal<string>;
     /**
-     * Event emitted when the checkbox value changes through user interaction.
+     * @description Emitido quando o valor do checkbox é alterado pelo usuário.
+     * Emite o novo valor booleano (`true` para marcado, `false` para desmarcado).
      */
     readonly checkedChange: import("@angular/core").OutputEmitterRef<boolean>;
     private _onChange;
     private _onTouched;
     private _hasUserInteracted;
     /**
-     * Checks if the checkbox should display the indeterminate state.
-     * Computed signal that only recalculates when dependencies change.
+     * @description Computed que indica se o estado indeterminado deve ser exibido.
+     * Retorna `true` enquanto `indeterminate` for `true` e o usuário não tiver interagido.
      */
     readonly isIndeterminate: import("@angular/core").Signal<boolean>;
     toggle(): void;