@seniorsistemas/angular-components 19.0.5 → 19.0.6

package/password-strength/lib/password-strength/password-strength.directive.d.ts

@@ -2,17 +2,70 @@ import { ApplicationRef, ComponentFactoryResolver, ElementRef, Injector, OnInit
 import { PasswordStrengthPositions } from './types/password-positions';
 import { PasswordStrengths } from './types/password-strengths';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que adiciona o comportamento de verificação de força de senha
+ * a um campo de input existente. Ao receber foco ou a cada tecla digitada, exibe o
+ * componente {@link PasswordStrengthComponent} posicionado dinamicamente ao redor do campo,
+ * fornecendo feedback visual sobre a força da senha informada.
+ *
+ * @example
+ * ```html
+ * <input
+ *   type="password"
+ *   [sPasswordStrength]="true"
+ *   passwordStrengthDescription="A senha deve conter letras maiúsculas, números e caracteres especiais."
+ *   [passwordStrengthValidation]="myValidator" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class PasswordStrengthDirective implements OnInit {
     private readonly elementRef;
     private readonly appRef;
     private readonly componentFactoryResolver;
     private readonly injector;
+    /**
+     * @description Habilita ou desabilita o comportamento da diretiva.
+     * Quando `false`, o indicador de força não será exibido.
+     *
+     * @default true
+     */
     enabled: boolean;
+    /**
+     * @description Função customizada de validação da força da senha.
+     * Recebe o conteúdo atual do campo e deve retornar um valor do tipo {@link PasswordStrengths}
+     * (`'veryWeak'`, `'weak'`, `'medium'` ou `'strong'`).
+     * Se não informada, utiliza a validação padrão baseada em critérios de comprimento,
+     * letras maiúsculas/minúsculas, números e caracteres especiais.
+     */
     passwordStrengthValidation?: (content: string) => PasswordStrengths;
+    /**
+     * @description Posição preferencial onde o indicador de força será exibido em relação ao campo.
+     * Aceita `'right'`, `'left'` ou `'top'`. O componente tenta posicionar automaticamente
+     * em outro lado caso não haja espaço suficiente na posição especificada.
+     *
+     * @default 'right'
+     */
     passwordStrengthPosition: PasswordStrengthPositions;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como fraca.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthWeakTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como média.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthMediumTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como forte.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthStrongTitle?: string;
+    /**
+     * @description Descrição complementar exibida no indicador de força de senha,
+     * orientando o usuário sobre os requisitos da senha. Campo obrigatório.
+     */
     passwordStrengthDescription: string;
     private componentRef?;
     constructor(elementRef: ElementRef, appRef: ApplicationRef, componentFactoryResolver: ComponentFactoryResolver, injector: Injector);

package/picklist/lib/picklist/picklist.component.d.ts

@@ -9,21 +9,50 @@ interface InternalPicklistItem<T = any> extends PickListItem<T> {
 type CdkDragEvent = {
     source: CdkDrag<InternalPicklistItem<any>>;
 };
+/**
+ * @description Componente de lista de dupla seleção (picklist) com suporte a
+ * arrastar e soltar, filtro, checkboxes e template customizável para cada item.
+ * Emite eventos ao mover itens entre as listas.
+ *
+ * @example
+ * ```html
+ * <s-picklist
+ *   [itensToSelect]="itensDisponiveis"
+ *   [selectedItens]="itensSelecionados"
+ *   (selectedItensChange)="onSelecaoMudou($event)" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class PicklistComponent implements AfterViewInit, OnChanges {
     private cdr;
+    /** @description Lista de itens disponíveis para seleção (coluna esquerda). @default [] */
     itensToSelect: PickListItem<any>[];
+    /** @description Lista de itens já selecionados (coluna direita). @default [] */
     selectedItens: PickListItem<any>[];
+    /** @description Rótulo do título da lista de disponíveis. */
     availableItensLabel?: string;
+    /** @description Placeholder da busca na lista de disponíveis. */
     availableItensPlaceholder?: string;
+    /** @description Rótulo do botão de adicionar itens selecionados. */
     addSelectedItensLabel?: string;
+    /** @description Rótulo do botão de adicionar todos os itens. */
     addAllItensLabel?: string;
+    /** @description Rótulo do título da lista de selecionados. */
     selectedItensLabel?: string;
+    /** @description Placeholder da busca na lista de selecionados. */
     selectedItensPlaceholder?: string;
+    /** @description Rótulo do botão de remover itens selecionados. */
     removeSelectedItemsLabel?: string;
+    /** @description Rótulo do botão de remover todos os itens. */
     removeAllItemsLabel?: string;
+    /** @description Exibe checkbox nos itens das listas. @default false */
     showCheckbox: boolean;
+    /** @description Propriedade usada para filtrar os itens das listas. @default '' */
     filterBy: string;
+    /** @description Emitido quando a lista de selecionados muda. */
     selectedItensChange: EventEmitter<any[]>;
+    /** @description Emitido quando a lista de disponíveis muda. */
     itensToSelectChange: EventEmitter<any[]>;
     availableItensFilter: string;
     selectedItensFilter: string;

package/pin-code-field/lib/pin-code-field/pin-code-field.component.d.ts

@@ -2,19 +2,18 @@ import { ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
 /**
- * Pin Code Field Component
+ * @description Componente de entrada de código PIN/OTP com campos individuais para cada dígito.
+ * Implementa {@link ControlValueAccessor} para integração nativa com Reactive Forms
+ * e Template-driven Forms do Angular.
  *
- * A flexible, accessible PIN code input component that implements {@link ControlValueAccessor}
- * for seamless integration with Angular Reactive Forms and Template-driven Forms.
- *
- * Features:
- * - Multiple input fields for PIN/OTP code entry
- * - Configurable code length and character validation
- * - Keyboard navigation (arrow keys, backspace)
- * - Paste support with automatic truncation
- * - Error state display via the `invalid` input
- * - Full accessibility support (ARIA labels, semantic roles)
- * - Signal-based state management
+ * Funcionalidades:
+ * - Campos separados e navegáveis para cada dígito do código
+ * - Comprimento configurável via input `length`
+ * - Suporte a entrada numérica ou alfanumérica
+ * - Navegação por teclado (setas, backspace)
+ * - Suporte a colar (paste) com truncamento automático ao tamanho definido
+ * - Estado de erro via input `invalid`
+ * - Acessibilidade completa com ARIA labels e roles semânticos
  *
  * @example
  * ```html
@@ -24,46 +23,42 @@ import * as i0 from "@angular/core";
  *     [length]="6"
  *     [alphanumeric]="false"
  *     [invalid]="(form.get('code')?.invalid && form.get('code')?.dirty) || false"
- *     helpText="Enter your 6-digit code"
+ *     helpText="Digite seu código de 6 dígitos"
  *     (codeFilled)="onCodeFilled($event)">
  *   </s-pin-code-field>
  * </form>
  * ```
  *
- * @example
- * ```typescript
- * form = this.fb.group({
- *   code: ['', [Validators.required]],
- * });
- * ```
+ * @category Inputs
  */
 export declare class PinCodeFieldComponent implements ControlValueAccessor {
     private static readonly LAST_INDEX_OFFSET;
     private static readonly EMPTY_VALUE;
     /**
-     * Number of input fields (PIN code length).
-     * Must be at least 1.
+     * @description Número de campos de entrada (comprimento do código PIN).
+     * Deve ser ao menos 1.
      *
      * @default 6
      */
     length: import("@angular/core").InputSignal<number>;
     /**
-     * Allows alphanumeric and special characters input.
-     * When false, only numeric input (0-9) is accepted.
+     * @description Permite entrada alfanumérica e de caracteres especiais.
+     * Quando `false`, aceita apenas dígitos numéricos (0–9).
      *
      * @default false
      */
     alphanumeric: import("@angular/core").InputSignal<boolean>;
     /**
-     * Help text displayed below the input fields.
+     * @description Texto de ajuda exibido abaixo dos campos de entrada,
+     * fornecendo instruções adicionais ao usuário.
      *
      * @default ''
      */
     helpText: import("@angular/core").InputSignal<string>;
     /**
-     * Controls the error state visualization of the component.
-     * When true, displays red border on input fields.
-     * Typically bound to FormControl's invalid and dirty state.
+     * @description Controla a visualização do estado de erro do componente.
+     * Quando `true`, exibe borda vermelha nos campos de entrada.
+     * Normalmente vinculado ao estado `invalid && dirty` do `FormControl`.
      *
      * @example
      * ```html
@@ -73,15 +68,15 @@ export declare class PinCodeFieldComponent implements ControlValueAccessor {
      */
     invalid: import("@angular/core").InputSignal<boolean>;
     /**
-     * Two-way binding for the disabled state of the component.
-     * Disables all input fields and prevents user interaction.
+     * @description Controla o estado desabilitado do componente via two-way binding.
+     * Quando `true`, todos os campos ficam desabilitados e a interação do usuário é bloqueada.
      *
      * @default false
      */
     disabled: import("@angular/core").ModelSignal<boolean>;
     /**
-     * Emitted when all PIN code fields are filled.
-     * Emits the complete PIN code as a string.
+     * @description Emitido quando todos os campos do código PIN são preenchidos.
+     * Emite o código completo como string.
      *
      * @example
      * ```html
@@ -90,8 +85,8 @@ export declare class PinCodeFieldComponent implements ControlValueAccessor {
      */
     codeFilled: import("@angular/core").OutputEmitterRef<string>;
     /**
-     * Signal containing the current values of each input field.
-     * Array length matches the `length` input value.
+     * @description Signal com os valores atuais de cada campo de entrada.
+     * O comprimento do array corresponde ao valor do input `length`.
      */
     inputs: import("@angular/core").WritableSignal<string[]>;
     /**

package/profile-picture-picker/lib/profile-picture-picker/profile-picture-picker.component.d.ts

@@ -5,32 +5,116 @@ import { ConfirmationService } from 'primeng/api';
 import { ConfirmationTexts, CropperLabelsConfig, FileValidationErrors, ProfilePicturePickerData } from './models/index';
 import { ImageCropperService } from '@seniorsistemas/angular-components/image-cropper';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente para seleção, edição e remoção de foto de perfil do usuário.
+ * Permite ao usuário fazer upload de uma imagem, recortá-la com o {@link ImageCropperService}
+ * e confirmar ou remover a foto atual. Implementa {@link ControlValueAccessor} para uso
+ * em formulários reativos e template-driven do Angular.
+ *
+ * @example
+ * ```html
+ * <s-profile-picture-picker
+ *   formControlName="avatar"
+ *   subtitle="Formatos aceitos: JPG e PNG"
+ *   [maxFileSize]="2097152"
+ *   accept="image/jpeg,image/png"
+ *   (imageChange)="onImageChange($event)"
+ *   (removedImage)="onImageRemoved()" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ProfilePicturePickerComponent implements OnInit, ControlValueAccessor {
     private readonly imageCropperService;
     private readonly confirmationService;
     private readonly translateService;
+    /**
+     * @description Título simples exibido quando nenhuma imagem está selecionada.
+     */
     simpleTitle: string;
+    /**
+     * @description Título de ação exibido como label principal do botão de upload.
+     */
     actionTitle: string;
+    /**
+     * @description Legenda exibida abaixo do título, descrevendo formatos suportados
+     * ou outras orientações para o usuário. Campo obrigatório.
+     */
     subtitle: string;
+    /**
+     * @description Proporção (aspect ratio) do recorte da imagem.
+     * Por exemplo, `1` para quadrado, `16/9` para widescreen.
+     *
+     * @default 1
+     */
     aspectRatio: number;
+    /**
+     * @description Configurações de rótulos exibidos no componente de recorte de imagem (cropper).
+     * Permite sobrescrever os textos padrão dos botões e instruções do cropper.
+     */
     cropperLabelsConfig?: CropperLabelsConfig;
+    /**
+     * @description Texto do botão de remoção da foto atual.
+     * Se não informado, utiliza o label padrão de remoção.
+     */
     removeButtonLabel?: string;
+    /**
+     * @description Texto do botão de troca da foto atual.
+     * Se não informado, utiliza o label padrão de alteração.
+     */
     changeButtonLabel?: string;
+    /**
+     * @description Textos personalizados exibidos no diálogo de confirmação
+     * ao remover ou substituir a foto. Permite sobrescrever título, mensagem e botões.
+     */
     confirmationTexts?: ConfirmationTexts;
+    /**
+     * @description Tamanho máximo permitido para o arquivo de imagem, em bytes.
+     * Quando o arquivo excede esse limite, o output `invalidFile` é emitido.
+     */
     maxFileSize?: number;
+    /**
+     * @description Tipos MIME aceitos pelo input de arquivo.
+     * Exemplo: `"image/jpeg,image/png"`.
+     */
     accept?: string;
+    /**
+     * @description Lista de extensões de arquivo aceitas para validação.
+     * Exemplo: `['.jpg', '.jpeg', '.png']`.
+     *
+     * @default []
+     */
     supportedExtensions: string[];
+    /**
+     * @description Imagem atual do componente. Pode ser uma string base64, um objeto
+     * {@link ProfilePicturePickerData} com metadados, ou `null` para sem imagem.
+     *
+     * @default null
+     */
     image: string | ProfilePicturePickerData | null;
     uploadPicture: ElementRef | null;
     info: ElementRef | null;
     thumbnail: ElementRef | null;
     fileInput: ElementRef | null;
     /**
-     * @deprecated Use imageChange instead.
+     * @deprecated Use `imageChange` em vez deste output.
+     * @description Emitido ao selecionar ou recortar uma nova imagem. Emite a string base64 da imagem.
      */
     changedImage: EventEmitter<string>;
+    /**
+     * @description Emitido ao selecionar, recortar ou alterar a imagem.
+     * Emite a string base64 ou um objeto {@link ProfilePicturePickerData} com os dados da imagem.
+     */
     imageChange: EventEmitter<string | ProfilePicturePickerData>;
+    /**
+     * @description Emitido quando o usuário confirma a remoção da foto atual.
+     */
     removedImage: EventEmitter<any>;
+    /**
+     * @description Emitido quando o arquivo selecionado não passa na validação.
+     * Emite um objeto {@link FileValidationErrors} descrevendo os erros encontrados
+     * (ex.: tamanho excedido, extensão inválida).
+     */
     invalidFile: EventEmitter<FileValidationErrors>;
     get imageBase64(): string;
     private _onChange?;

package/progressbar/lib/progressbar/progressbar.component.d.ts

@@ -1,14 +1,64 @@
 import { OnInit } from '@angular/core';
 import { ProgressBarColors, ProgressBarMode } from './types';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de barra de progresso que representa visualmente o avanço de uma tarefa.
+ * Suporta modo determinado (valor percentual) e indeterminado (progresso desconhecido),
+ * além de um valor-alvo para comparação.
+ *
+ * @example
+ * ```html
+ * <s-progressbar
+ *   [value]="75"
+ *   activeColor="blue"
+ *   label="Upload"
+ *   [showValue]="true"
+ * />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class ProgressBarComponent implements OnInit {
+    /**
+     * @description Valor atual do progresso, em percentual (0 a 100).
+     * Não utilizado quando `mode` é `'indeterminate'`.
+     * Lança erro se o valor estiver fora do intervalo permitido.
+     */
     value: number;
+    /**
+     * @description Cor ativa da barra de progresso. Campo obrigatório.
+     * Valores aceitos: `'blue'`, `'green'`, `'red'`, `'yellow'`.
+     */
     activeColor: ProgressBarColors;
+    /**
+     * @description Opções de formatação numérica utilizadas para exibir o valor percentual.
+     * Baseado na API `Intl.NumberFormat`.
+     *
+     * @default `{ style: 'decimal', minimumFractionDigits: 0, maximumFractionDigits: 2 }`
+     */
     numberFormatOptions: Intl.NumberFormatOptions;
+    /**
+     * @description Valor-alvo em percentual (0 a 100), exibido como marcador de referência na barra.
+     * Não utilizado quando `mode` é `'indeterminate'`.
+     */
     targetValue?: number;
+    /** @description Rótulo descritivo exibido ao lado da barra de progresso principal. */
     label?: string;
+    /** @description Rótulo descritivo exibido ao lado do marcador de valor-alvo. */
     targetLabel?: string;
+    /**
+     * @description Quando `true`, exibe o valor percentual atual sobre ou próximo da barra.
+     *
+     * @default true
+     */
     showValue: boolean;
+    /**
+     * @description Modo de operação da barra de progresso.
+     * - `'determinate'`: exibe o progresso baseado em `value` (padrão).
+     * - `'indeterminate'`: animação contínua sem valor definido; `value`, `targetValue` e `targetLabel` não devem ser usados.
+     *
+     * @default 'determinate'
+     */
     mode: ProgressBarMode;
     ngOnInit(): void;
     private validateInputs;

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>;