@seniorsistemas/angular-components 19.0.4 → 19.0.6

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

@@ -1,6 +1,23 @@
 import { OnDestroy, OnInit } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de botão de opção (radio button) individual que implementa
+ * {@link ControlValueAccessor} para integração com formulários Angular.
+ * Pode ser usado de forma independente ou agrupado dentro de {@link RadioButtonGroupComponent}
+ * para garantir a exclusividade de seleção entre os itens do grupo.
+ *
+ * @example
+ * ```html
+ * <s-radiobutton
+ *   name="opcao"
+ *   label="Opção A"
+ *   value="A"
+ *   [(ngModel)]="selecionado" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class RadioButtonComponent implements ControlValueAccessor, OnInit, OnDestroy {
     private static ID;
     private readonly radioButtonRegistry;
@@ -11,12 +28,22 @@ export declare class RadioButtonComponent implements ControlValueAccessor, OnIni
     protected onTouched: (value: unknown) => void;
     protected checked: boolean | null;
     protected formItemDisabled: import("@angular/core").WritableSignal<boolean>;
+    /** @description Controla o estado desabilitado do botão via two-way binding. @default false */
     buttonDisabled: import("@angular/core").ModelSignal<boolean>;
+    /** @description Texto do label exibido ao lado do botão de opção. Campo obrigatório. */
     label: import("@angular/core").InputSignal<string>;
+    /** @description Nome do grupo de radio buttons. Deve ser igual para todos os botões do mesmo grupo. Campo obrigatório. */
     name: import("@angular/core").InputSignal<string>;
+    /** @description Valor associado a este botão de opção. Emitido ao formulário quando o item é selecionado. Campo obrigatório. */
     value: import("@angular/core").ModelSignal<unknown>;
+    /**
+     * @description Identificador único do elemento `<input>` interno, usado para acessibilidade.
+     * Gerado automaticamente se não informado.
+     */
     inputId: import("@angular/core").InputSignal<string>;
+    /** @description Emitido quando o campo interno recebe foco. */
     focusedInput: import("@angular/core").OutputEmitterRef<FocusEvent>;
+    /** @description Emitido quando o campo interno perde o foco. */
     inputFocusLost: import("@angular/core").OutputEmitterRef<FocusEvent>;
     registerOnChange(fn: (value: unknown) => void): void;
     registerOnTouched(fn: () => void): void;

package/radio-button/lib/radio-button-group/radio-button-group.component.d.ts

@@ -1,13 +1,39 @@
 import { ControlValueAccessor } from '@angular/forms';
 import { RadioButtonGroupItem } from './models/radio-button-group.models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de grupo de botões de opção (radio button group) que gerencia
+ * a seleção exclusiva entre múltiplas opções. Implementa {@link ControlValueAccessor}
+ * para uso com Reactive Forms e Template-driven Forms do Angular.
+ * Renderiza internamente componentes {@link RadioButtonComponent} para cada item configurado.
+ *
+ * @example
+ * ```html
+ * <s-radiobutton-group
+ *   formControlName="opcao"
+ *   inputName="plano"
+ *   [items]="planos"
+ *   viewMode="vertical" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class RadioButtonGroupComponent implements ControlValueAccessor {
     protected onChange: (value: unknown) => void;
     protected onTouched: (value: unknown) => void;
     protected modelValue: import("@angular/core").WritableSignal<unknown>;
+    /** @description Controla o estado desabilitado de todos os botões do grupo via two-way binding. @default false */
     readonly disabled: import("@angular/core").ModelSignal<boolean>;
+    /** @description Lista de itens que serão renderizados como opções do grupo. Campo obrigatório. */
     readonly items: import("@angular/core").InputSignal<RadioButtonGroupItem[]>;
+    /** @description Atributo `name` compartilhado entre todos os radio buttons do grupo, garantindo exclusividade. Campo obrigatório. */
     readonly inputName: import("@angular/core").InputSignal<string>;
+    /**
+     * @description Direção de layout dos botões de opção.
+     * `'horizontal'` exibe os botões lado a lado; `'vertical'` os empilha.
+     *
+     * @default 'horizontal'
+     */
     readonly viewMode: import("@angular/core").InputSignal<"horizontal" | "vertical">;
     registerOnChange(fn: (value: unknown) => void): void;
     registerOnTouched(fn: () => void): void;

package/rating-scale/lib/rating-scale/rating-scale.component.d.ts

@@ -1,10 +1,38 @@
-import { RatingScaleNode } from "./models/rating-scale-node";
-import { ControlValueAccessor } from "@angular/forms";
+import { RatingScaleNode } from './models/rating-scale-node';
+import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de escala de avaliação que permite ao usuário selecionar um nó de uma escala visual.
+ * Implementa `ControlValueAccessor` para integração com Reactive Forms e Template-Driven Forms.
+ * Ideal para pesquisas de satisfação (NPS, CSAT) e questionários de feedback.
+ *
+ * @example
+ * ```html
+ * <s-rating-scale
+ *   [nodes]="ratingNodes"
+ *   startLabel="Péssimo"
+ *   endLabel="Ótimo"
+ *   [(ngModel)]="rating"
+ * />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class RatingScaleComponent implements ControlValueAccessor {
+    /**
+     * @description Lista de nós que compõem a escala de avaliação. Campo obrigatório.
+     * Cada `RatingScaleNode` define o valor, rótulo e cor do item na escala.
+     */
     nodes: RatingScaleNode[];
+    /** @description Rótulo exibido no início (extremidade esquerda) da escala. */
     startLabel?: string;
+    /** @description Rótulo exibido no final (extremidade direita) da escala. */
     endLabel?: string;
+    /**
+     * @description Quando `true`, a escala fica desabilitada e o usuário não pode selecionar nenhum nó.
+     *
+     * @default false
+     */
     disabled: boolean;
     value?: RatingScaleNode;
     private _onChange?;

package/select/lib/select/select.component.d.ts

@@ -6,22 +6,56 @@ interface InternalDropdownOption<T> {
     id: string;
     grouper?: boolean;
 }
+/**
+ * @description Componente de seleção dropdown genérico com suporte a seleção simples e múltipla,
+ * filtro, agrupamento, virtual scroll e acessibilidade (ARIA combobox). Implementa
+ * {@link ControlValueAccessor} para integração com Reactive Forms e Template-driven Forms.
+ *
+ * @example
+ * ```html
+ * <s-select
+ *   formControlName="categoria"
+ *   placeholder="Selecione uma categoria"
+ *   [options]="categorias"
+ *   optionLabel="nome"
+ *   optionValue="id"
+ *   [filter]="true"
+ *   [showClear]="true" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SelectComponent<T> implements ControlValueAccessor, OnInit {
     private static nextId;
+    /** @description Texto exibido quando nenhuma opção está selecionada. @default '' */
     placeholder: import("@angular/core").InputSignal<string>;
+    /** @description Habilita a seleção de múltiplas opções simultâneas. @default false */
     multiple: import("@angular/core").InputSignal<boolean>;
+    /** @description Lista de opções disponíveis para seleção. Campo obrigatório. */
     options: import("@angular/core").InputSignal<T[]>;
+    /** @description Chave do objeto de opção usada como label de exibição. */
     optionLabel: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Chave do objeto de opção usada como valor a ser emitido ao formulário. */
     optionValue: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Exibe um botão para limpar a seleção atual. @default false */
     showClear: import("@angular/core").InputSignal<boolean>;
+    /** @description Habilita um campo de filtro textual para pesquisa nas opções. @default false */
     filter: import("@angular/core").InputSignal<boolean>;
+    /** @description Exibe um ícone de checkmark ao lado da opção selecionada. @default false */
     checkmark: import("@angular/core").InputSignal<boolean>;
+    /** @description Chave(s) do objeto usada(s) para filtragem textual. Quando não informado, usa `optionLabel`. */
     filterBy: import("@angular/core").InputSignal<keyof T | (keyof T)[] | undefined>;
+    /** @description Habilita agrupamento de opções. As opções devem conter itens filhos conforme a estrutura de grupo suportada. @default false */
     group: import("@angular/core").InputSignal<boolean>;
+    /** @description Habilita virtualização da lista para melhor performance com grandes volumes de opções. @default false */
     virtualScroll: import("@angular/core").InputSignal<boolean>;
+    /** @description Altura fixa de cada item da lista em pixels, necessária para o cálculo do virtual scroll. @default 37 */
     virtualScrollItemSize: import("@angular/core").InputSignal<number>;
+    /** @description Mensagem exibida quando nenhuma opção corresponde ao filtro aplicado. @default null */
     emptyMessage: import("@angular/core").InputSignal<string | null>;
+    /** @description Controla o estado desabilitado do componente via two-way binding. @default false */
     disabled: import("@angular/core").ModelSignal<boolean>;
+    /** @description Controla a visibilidade do painel de opções via two-way binding. @default false */
     showOptions: import("@angular/core").ModelSignal<boolean>;
     value: import("@angular/core").WritableSignal<InternalDropdownOption<T> | null>;
     values: import("@angular/core").WritableSignal<InternalDropdownOption<T>[]>;

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

@@ -2,10 +2,44 @@ import { EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { SelectButtonItem } from './models/select-button-item';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de seleção por botões agrupados, onde cada opção é representada
+ * visualmente como um botão clicável. Suporta seleção simples e múltipla. Implementa
+ * {@link ControlValueAccessor} para integração com formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-select-button
+ *   formControlName="visualizacao"
+ *   [items]="opcoesVisualizacao"
+ *   [multiple]="false"
+ *   (itemSelected)="onVisualizacaoChange($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SelectButtonComponent implements ControlValueAccessor {
+    /**
+     * @description Lista de itens exibidos como botões de seleção.
+     * Cada item pode possuir `label`, `value` e `disabled`. Campo obrigatório.
+     */
     items: SelectButtonItem[];
+    /**
+     * @description Habilita a seleção de múltiplos itens ao mesmo tempo.
+     * Quando `false`, apenas um item pode estar ativo por vez.
+     *
+     * @default false
+     */
     multiple: boolean;
+    /**
+     * @description Emitido após a seleção de um item, com a lista completa dos itens
+     * atualmente selecionados (array de {@link SelectButtonItem}).
+     */
     itemSelected: EventEmitter<SelectButtonItem[]>;
+    /**
+     * @description Emitido no momento do clique em um item, antes da atualização
+     * do estado de seleção. Útil para side-effects imediatos ao clique.
+     */
     itemClicked: EventEmitter<SelectButtonItem>;
     disabled: boolean;
     activeItems: Set<SelectButtonItem>;

package/shared/lib/shared/border-button/border-button.component.d.ts

@@ -1,8 +1,16 @@
-import { BorderButtonOptions } from "../models/border-button-options";
-import { Severities } from "../models/severities";
+import { BorderButtonOptions } from '../models/border-button-options';
+import { Severities } from '../models/severities';
 import * as i0 from "@angular/core";
+/**
+ * @description Botão com borda que varia de estilo de acordo com a severidade informada.
+ * Utilizado internamente por outros componentes da biblioteca.
+ *
+ * @category Shared
+ */
 export declare class BorderButtonComponent {
+    /** @description Nível de severidade que define a cor e estilo do botão. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão (rótulo, ação, etc.). */
     options?: BorderButtonOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<BorderButtonComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BorderButtonComponent, "s-border-button", never, { "severity": { "alias": "severity"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, {}, never, never, false, never>;

package/sidebar/lib/sidebar/sidebar.component.d.ts

@@ -1,15 +1,68 @@
 import { AfterContentInit, OnDestroy, QueryList, TemplateRef } from '@angular/core';
 import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de painel lateral deslizante (sidebar) que aparece sobre o conteúdo
+ * vindo do lado direito da tela. Suporta templates customizados para cabeçalho, corpo e rodapé
+ * via `sTemplate`, bloqueio de scroll automático e confirmação de fechamento.
+ *
+ * @example
+ * ```html
+ * <s-sidebar [(visible)]="sidebarOpen" header="Filtros" [closable]="true">
+ *   <ng-template sTemplate="body">Conteúdo</ng-template>
+ * </s-sidebar>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class SidebarComponent implements AfterContentInit, OnDestroy {
     templates: QueryList<TemplateDirective> | null;
+    /**
+     * @description Controla a visibilidade da sidebar. Suporta two-way binding via `[(visible)]`.
+     *
+     * @default false
+     */
     visible: import("@angular/core").ModelSignal<boolean>;
+    /**
+     * @description Quando `true`, exibe o botão de fechar (X) no cabeçalho da sidebar.
+     *
+     * @default true
+     */
     closable: boolean;
+    /**
+     * @description Quando `true`, clicar no backdrop (área escurecida fora da sidebar) fecha o painel.
+     *
+     * @default true
+     */
     dismissible: boolean;
+    /**
+     * @description Quando `true`, pressionar a tecla Escape fecha a sidebar.
+     *
+     * @default true
+     */
     closeOnEscape: boolean;
+    /**
+     * @description Texto exibido no cabeçalho padrão da sidebar.
+     * Pode ser substituído por um template customizado via `sTemplate="header"`.
+     */
     header?: string;
+    /**
+     * @description Quando `true`, aumenta a largura da sidebar para acomodar mais conteúdo.
+     *
+     * @default false
+     */
     largeSized: boolean;
+    /**
+     * @description Quando `true`, mantém o conteúdo da sidebar no DOM mesmo quando oculta,
+     * preservando o estado interno dos componentes filhos.
+     *
+     * @default false
+     */
     cache: boolean;
+    /**
+     * @description Função de confirmação chamada antes de fechar a sidebar.
+     * Quando retornar `false`, o fechamento é bloqueado. Útil para validar formulários não salvos.
+     */
     set registerConfirmClose(fn: () => boolean);
     headerTemplate: TemplateRef<unknown> | null;
     bodyTemplate: TemplateRef<unknown> | null;

package/slide-in-bar/lib/slide-in-bar/slide-in-bar.component.d.ts

@@ -1,17 +1,68 @@
-import { AfterViewChecked, AfterViewInit, EventEmitter, OnDestroy, OnInit } from "@angular/core";
-import { SlideInBarService } from "./slide-in-bar.service";
+import { AfterViewChecked, AfterViewInit, EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { SlideInBarService } from './slide-in-bar.service';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de painel deslizante lateral que expande/colapsa ao clicar em um botão de toggle.
+ * Em telas pequenas (≤ 420px), o painel entra em modo overlay, sobrepondo o conteúdo.
+ * Substitui o seletor `s-slide-panel` (deprecado desde v20.0.0).
+ *
+ * @example
+ * ```html
+ * <s-slide-in-bar [cache]="true" (panelOpened)="onOpen()">
+ *   <p>Conteúdo lateral</p>
+ * </s-slide-in-bar>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class SlideInBarComponent implements OnInit, AfterViewChecked, AfterViewInit, OnDestroy {
     private readonly slidePanelService;
     static nextId: number;
+    /**
+     * @description Identificador único do painel. Gerado automaticamente se não informado.
+     * Usado internamente pelo `SlideInBarService` para comunicação entre painéis.
+     */
     id: string;
+    /**
+     * @description Classe de ícone exibida no botão de abertura do painel.
+     *
+     * @default 'fas fa-chevron-right'
+     */
     openIcon: string;
+    /**
+     * @description Classe de ícone exibida no botão de fechamento do painel.
+     *
+     * @default 'fas fa-chevron-left'
+     */
     closeIcon: string;
+    /**
+     * @description Quando `true`, mantém o conteúdo do painel no DOM mesmo quando fechado,
+     * preservando o estado interno dos componentes filhos.
+     *
+     * @default false
+     */
     cache: boolean;
+    /**
+     * @description Quando `true`, o painel é iniciado já aberto.
+     *
+     * @default false
+     */
     createOpen: boolean;
+    /**
+     * @description Quando `true`, o painel não sobrepõe o conteúdo ao expandir,
+     * empurrando o layout adjacente.
+     *
+     * @default false
+     */
     noOverlap: boolean;
+    /**
+     * @description Emitido quando o painel é aberto pelo usuário.
+     */
     panelOpened: EventEmitter<void>;
+    /**
+     * @description Emitido quando o painel é fechado pelo usuário.
+     */
     panelClosed: EventEmitter<void>;
     isOpen: boolean;
     isSlideOver: boolean;

package/slider/lib/slider/slider.component.d.ts

@@ -1,20 +1,92 @@
 import { AfterViewInit, ElementRef, EventEmitter, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de controle deslizante (slider) para seleção de valores numéricos
+ * dentro de um intervalo definido. Suporta modo simples (um valor) e modo de intervalo
+ * (dois valores: início e fim). Implementa {@link ControlValueAccessor} para integração
+ * com Reactive Forms e Template-driven Forms do Angular.
+ *
+ * @example
+ * ```html
+ * <!-- Slider simples -->
+ * <s-slider formControlName="volume" [min]="0" [max]="100" [step]="5" />
+ *
+ * <!-- Slider de intervalo -->
+ * <s-slider formControlName="faixa" [multiple]="true" [min]="0" [max]="1000" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SliderComponent implements OnInit, AfterViewInit, ControlValueAccessor, OnChanges {
     private readonly MAX_RANGE_VALUE;
     private readonly MIN_RANGE_VALUE;
     track: ElementRef;
+    /**
+     * @description Habilita o modo de intervalo, permitindo selecionar um valor mínimo e máximo.
+     * Quando `true`, o valor do componente é um array `[inicio, fim]`.
+     *
+     * @default false
+     */
     multiple: boolean;
+    /**
+     * @description Valor atual do slider. No modo simples é um número; no modo de
+     * intervalo (`multiple: true`) é um array `[inicio, fim]`.
+     *
+     * @default 0
+     */
     value: number | [number, number];
+    /**
+     * @description Emitido sempre que o valor do slider é alterado pelo usuário.
+     * Emite o novo valor (número ou array de dois números no modo de intervalo).
+     */
     valueChange: EventEmitter<number | [number, number]>;
+    /**
+     * @description Incremento aplicado a cada movimento do thumb do slider.
+     *
+     * @default 1
+     */
     step: number;
+    /**
+     * @description Oculta visualmente o thumb (botão arrastável) do slider.
+     * Útil para visualizações onde apenas a faixa de progresso deve ser exibida.
+     *
+     * @default false
+     */
     hiddenThumb: boolean;
+    /**
+     * @description Desabilita a interação do usuário com o slider.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * @description Valor mínimo permitido no slider.
+     *
+     * @default 0
+     */
     min: number;
+    /**
+     * @description Valor máximo permitido no slider.
+     *
+     * @default 100
+     */
     max: number;
+    /**
+     * @description Label exibido abaixo ou ao lado do valor mínimo do slider.
+     * Útil para indicar semanticamente os extremos do intervalo.
+     */
     minValueLabel?: string;
+    /**
+     * @description Label exibido abaixo ou ao lado do valor máximo do slider.
+     * Útil para indicar semanticamente os extremos do intervalo.
+     */
     maxValueLabel?: string;
+    /**
+     * @description Índice de tabulação do elemento, controlando a ordem de foco via teclado.
+     *
+     * @default 0
+     */
     tabindex: number;
     startValue: number;
     endValue: number;

package/speech-recognition/lib/speech-recognition/speech-recognition/speech-recognition.component.d.ts

@@ -3,13 +3,30 @@ import { TranslateService } from '@ngx-translate/core';
 import { SpeechRecognitionService } from '../speech-recognition.service';
 import { TextToSpeechService } from '../text-to-speech.service';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de reconhecimento de voz que integra a Web Speech API para
+ * transcrever a fala do usuário em texto, inserída diretamente em um `<textarea>` fornecido.
+ * Suporta também text-to-speech para leitura em voz alta do conteúdo do campo.
+ *
+ * @example
+ * ```html
+ * <s-speech-recognition
+ *   [textAreaElement]="textAreaRef.nativeElement"
+ *   (recognizedText)="onTextoReconhecido($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     private readonly speechRecognitionService;
     private readonly textToSpeechService;
     private readonly translateService;
     private static TOOLBAR_ACTIVE;
+    /** @description Referência ao elemento `<textarea>` nativo que receberá o texto transcrito. Campo obrigatório. */
     textAreaElement: HTMLTextAreaElement;
+    /** @description Quando `true`, mantém o texto existente no campo ao iniciar novo reconhecimento. @default false */
     keepContext: boolean;
+    /** @description Placeholder exibido no textarea durante o reconhecimento de voz. @default '' */
     speechRecognitionPlaceholder: string;
     private _recognizedText;
     private originalTextAreaElementText;
@@ -28,6 +45,7 @@ export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     canRenderAprove: boolean;
     canRenderTextToSpeechToolbar: boolean;
     isPlayingTextToSpeech: boolean;
+    /** @description Emitido quando o reconhecimento de voz é concluído, com o texto transcrito. */
     recognizedText: EventEmitter<string>;
     constructor(speechRecognitionService: SpeechRecognitionService, textToSpeechService: TextToSpeechService, translateService: TranslateService);
     ngOnInit(): void;

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

@@ -2,13 +2,35 @@ import { EventEmitter, ElementRef } from '@angular/core';
 import { SplitButtonOption } from './models/split-button-option';
 import { SplitButtonType } from './models/split-button-type';
 import * as i0 from "@angular/core";
+/**
+ * @description Botão composto com ação principal e dropdown de opções adicionais.
+ * Ao clicar no botão principal emite `buttonClicked`; ao clicar no ícone de seta
+ * abre/fecha o dropdown com a lista de `options`.
+ *
+ * @example
+ * ```html
+ * <s-split-button
+ *   label="Salvar"
+ *   iconClass="fas fa-save"
+ *   [options]="menuOpcoes"
+ *   (buttonClicked)="onSalvar()" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SplitButtonComponent {
     private readonly _eRef;
+    /** @description Desabilita o botão principal e o dropdown. @default false */
     disabled: boolean;
+    /** @description Classe do ícone exibido no botão principal. Campo obrigatório. */
     iconClass: string;
+    /** @description Rótulo do botão principal. Campo obrigatório. */
     label: string;
+    /** @description Estilo visual do botão (`'primary'` ou `'secondary'`). @default 'primary' */
     type: SplitButtonType;
+    /** @description Lista de opções exibidas no dropdown. Campo obrigatório. */
     options: SplitButtonOption[];
+    /** @description Emitido quando o usuário clica no botão principal (não no dropdown). */
     buttonClicked: EventEmitter<any>;
     open: boolean;
     constructor(_eRef: ElementRef);

package/star-rating/star-rating/star-rating.component.d.ts

@@ -1,12 +1,28 @@
 import { ControlValueAccessor } from '@angular/forms';
 import { JustifyTypes } from './star-rating-models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de avaliação por estrelas com suporte a `ControlValueAccessor`
+ * para integração com formulários Angular. Permite configurar o número de estrelas,
+ * alinhamento e estado desabilitado. Clicar na estrela já selecionada a deseleciona.
+ *
+ * @example
+ * ```html
+ * <s-star-rating [starsRange]="5" formControlName="avaliacao" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class StarRatingComponent implements ControlValueAccessor {
     onChange: (value: number) => void;
     onTouched: (value: number) => void;
+    /** @description Índice da estrela atualmente selecionada (1-based). @default 0 */
     selectedStar: import("@angular/core").ModelSignal<number>;
+    /** @description Número total de estrelas exibidas. @default 5 */
     starsRange: import("@angular/core").InputSignal<number>;
+    /** @description Alinhamento horizontal das estrelas. @default 'center' */
     justifyContent: import("@angular/core").InputSignal<JustifyTypes>;
+    /** @description Desabilita a seleção de estrelas. @default false */
     disabled: import("@angular/core").ModelSignal<boolean>;
     protected readonly elementsRender: import("@angular/core").Signal<number[]>;
     writeValue(obj: number): void;

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

@@ -1,17 +1,44 @@
 import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Card de estatística que exibe um valor numérico com ícone,
+ * rótulo e animação de contagem. Suporta diferentes estilos visuais
+ * (borda, versão leve) e pode emitir evento ao ser clicado.
+ *
+ * @example
+ * ```html
+ * <s-stats-card
+ *   label="Vendas"
+ *   [value]="'1.234'"
+ *   iconClass="fas fa-shopping-cart"
+ *   color="#3399ff" />
+ * ```
+ *
+ * @category Summary
+ */
 export declare class StatsCardComponent {
     static nextId: number;
+    /** @description Identificador único do card no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Rótulo descritivo da estatística exibida. Campo obrigatório. */
     label: string;
+    /** @description Exibe borda mesmo quando o card não está em destaque. @default false */
     alwaysWithBorder: boolean;
+    /** @description Ativa a versão visual leve (sem sombra e com fundo claro). @default false */
     lightVersion: boolean;
+    /** @description Ativa o modo de cores claras para o card. @default true */
     lightMode: boolean;
+    /** @description Classe do ícone exibido no card. @default 'fa fa-bar-chart' */
     iconClass: string;
+    /** @description Cor de destaque do card em formato CSS. @default '#339966' */
     color: string;
+    /** @description Habilita a animação de contagem ao atualizar o valor. @default true */
     animateNumbers: boolean;
+    /** @description Habilita o cursor de ponteiro e o evento de clique. @default false */
     clickable: boolean;
+    /** @description Texto do tooltip exibido ao passar o mouse sobre o card. @default '' */
     tooltip: string;
+    /** @description Emitido quando o usuário clica no card (requer `clickable = true`). */
     clicked: EventEmitter<MouseEvent>;
     displayValue?: string;
     private _ANIMATION_DURATION_MS;
@@ -20,6 +47,7 @@ export declare class StatsCardComponent {
     private _intervalId;
     private _value;
     get value(): string;
+    /** @description Valor numérico exibido no card. Quando `animateNumbers` está ativo, a contagem é animada. */
     set value(value: string);
     replaceNumericPositions(value: string, newValue?: BigNumber): string;
     private _updateDisplayValue;