@seniorsistemas/angular-components 19.0.5 → 19.0.6

package/kanban/lib/kanban/kanban.component.d.ts

@@ -1,16 +1,36 @@
-import { CdkDragDrop } from "@angular/cdk/drag-drop";
-import { AfterContentInit, EventEmitter, OnDestroy, OnInit, QueryList, TemplateRef } from "@angular/core";
-import { KanbanEventService } from "./kanban-event.service";
-import { KanbanColumn, KanbanData, KanbanItem, KanbanItemMovedData } from "./types/index";
-import { TemplateDirective } from "@seniorsistemas/angular-components/template";
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import { AfterContentInit, EventEmitter, OnDestroy, OnInit, QueryList, TemplateRef } from '@angular/core';
+import { KanbanEventService } from './kanban-event.service';
+import { KanbanColumn, KanbanData, KanbanItem, KanbanItemMovedData } from './types/index';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de quadro Kanban com suporte a arrastar e soltar colunas e itens.
+ * Permite seleção via checkboxes, templates customizáveis para cabeçalho, corpo e rodapé
+ * dos cards, além de emitir eventos de movição e seleção.
+ *
+ * @example
+ * ```html
+ * <s-kanban
+ *   [data]="dadosKanban"
+ *   (itemsMoved)="onItemMovido($event)" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class KanbanComponent implements OnInit, AfterContentInit, OnDestroy {
     private readonly kanbanEventService;
+    /** @description Dados do quadro Kanban com colunas e itens. Campo obrigatório. */
     data: KanbanData;
+    /** @description Exibe checkboxes de seleção em cada item Kanban. @default true */
     showItemCheckboxes: boolean;
+    /** @description Exibe checkboxes de seleção no cabeçalho de cada coluna. @default true */
     showColumnCheckboxes: boolean;
+    /** @description Emitido quando o usuário move um item entre colunas ou posições. */
     itemsMoved: EventEmitter<KanbanItemMovedData>;
+    /** @description Emitido quando os dados do quadro são atualizados após movição. */
     dataUpdated: EventEmitter<KanbanData>;
+    /** @description Emitido quando a seleção de itens muda, com a lista de itens selecionados. */
     itemsSelected: EventEmitter<KanbanItem[]>;
     selectedColumn: KanbanColumn | null;
     selectedItems: Set<KanbanItem>;

package/label-value/lib/label-value/label-value.component.d.ts

@@ -1,6 +1,19 @@
 import { BadgeConfiguration, CurrencyConfiguration, DateConfiguration, LabelValueConfiguration, NumberConfiguration, TextConfiguration } from './types/label-value-configuration';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de exibição de par label/valor que suporta diferentes
+ * tipos de conteúdo configurados via `LabelValueConfiguration`: texto, número,
+ * moeda, data e badge.
+ *
+ * @example
+ * ```html
+ * <s-label-value [configuration]="{ type: 'Text', label: 'Nome', value: 'João' }" />
+ * ```
+ *
+ * @category Summary
+ */
 export declare class LabelValueComponent {
+    /** @description Configuração do par label/valor, incluindo tipo e dados para renderização. Campo obrigatório. */
     configuration: LabelValueConfiguration;
     isBadgeConfiguration(config: LabelValueConfiguration): config is BadgeConfiguration;
     isTextConfiguration(config: LabelValueConfiguration): config is TextConfiguration;

package/loading-state/lib/loading-state/loading-state.component.d.ts

@@ -1,11 +1,47 @@
 import { OnDestroy, TemplateRef } from '@angular/core';
 import { LoadingStateIndicators } from './components/loading-state-indicators';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de estado de carregamento que exibe um indicador animado enquanto
+ * um processo assíncrono está em andamento. Suporta bloqueio da janela inteira
+ * e diferentes tipos de indicadores visuais.
+ * Também pode ser usado como diretiva estrutural `[sLoadingState]`.
+ *
+ * @example
+ * ```html
+ * <s-loading-state [loading]="isLoading" [blockWindow]="true">
+ *   <p>Conteúdo carregado!</p>
+ * </s-loading-state>
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class LoadingStateComponent implements OnDestroy {
     static nextId: number;
+    /**
+     * @description Tipo de indicador visual exibido durante o carregamento.
+     * - `LoadingStateIndicators.Dots`: indicador de pontos animados (padrão).
+     * - `LoadingStateIndicators.Logo`: indicador com logotipo animado.
+     *
+     * @default LoadingStateIndicators.Dots
+     */
     indicator: LoadingStateIndicators;
+    /**
+     * @description Identificador único do componente. Gerado automaticamente se não informado.
+     */
     id: string;
+    /**
+     * @description Quando `true`, bloqueia a janela inteira durante o carregamento,
+     * sobrepondo todo o conteúdo da página com o indicador.
+     *
+     * @default false
+     */
     blockWindow: boolean;
+    /**
+     * @description Controla o estado de carregamento do componente. Campo obrigatório.
+     * Quando `true`, exibe o indicador de carregamento após um breve delay.
+     * Quando `false`, remove o indicador após um breve delay (evita flash).
+     */
     set loading(loading: boolean);
     get loading(): boolean;
     contents: TemplateRef<any> | null;

package/loading-state/lib/loading-state/loading-state.directive.d.ts

@@ -1,11 +1,34 @@
 import { AfterViewInit, ChangeDetectorRef, ComponentFactoryResolver, OnDestroy, TemplateRef, ViewContainerRef } from '@angular/core';
 import { LoadingStateIndicators } from './components/loading-state-indicators';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva estrutural que envolve o conteúdo da view com um indicador de carregamento.
+ * É uma alternativa inline ao `LoadingStateComponent`, podendo ser aplicada diretamente
+ * em containers existentes sem a necessidade de criar um wrapper explícito no template.
+ *
+ * @example
+ * ```html
+ * <!-- Forma simples (boolean) -->
+ * <div *sLoadingState="isLoading">Conteúdo</div>
+ *
+ * <!-- Forma com configuração -->
+ * <div *sLoadingState="{ loading: isLoading, indicator: 'logo' }">Conteúdo</div>
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class LoadingStateDirective implements AfterViewInit, OnDestroy {
     private readonly target;
     private readonly template;
     private readonly componentFactoryResolver;
     private readonly cdr;
+    /**
+     * @description Controla o estado de carregamento da diretiva.
+     * Aceita:
+     * - `boolean`: ativa/desativa o carregamento com o indicador padrão (`dots`).
+     * - `{ loading: boolean; indicator?: LoadingStateIndicators }`: permite configurar
+     *   o tipo de indicador junto com o estado de carregamento.
+     */
     set sLoadingState(value: boolean | {
         loading: boolean;
         indicator?: LoadingStateIndicators;

package/locale/lib/locale/locale.service.d.ts

@@ -5,6 +5,13 @@ import { LocaleOptions } from './options/index';
 import 'moment/locale/es';
 import 'moment/locale/pt-br';
 import * as i0 from "@angular/core";
+/**
+ * @description Serviço de localização que obtém e armazena o locale do usuário
+ * a partir da plataforma Senior. Fornece separadores decimais e de milhar,
+ * configurações de calendário e opções de formato PrimeNG com base no locale ativo.
+ *
+ * @category Locale
+ */
 export declare class LocaleService {
     private readonly http;
     private readonly cookieService;

package/localized-number-input/lib/localized-number-input/localized-number-input.directive.d.ts

@@ -2,10 +2,26 @@ import { OnInit } from '@angular/core';
 import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import { LocaleService } from '@seniorsistemas/angular-components/locale';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva de validação para campos `<input>` que verificam se o valor digitado
+ * é um número localizado válido (considerando separadores decimal e de milhar do locale ativo).
+ * Ao ser integrada ao `NG_VALIDATORS`, adiciona o erro `invalidNumber` ao control quando
+ * o valor não corresponde ao formato esperado.
+ *
+ * @example
+ * ```html
+ * <input sLocalizedNumberInput [precision]="4" formControlName="valor" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class LocalizedNumberInputDirective implements OnInit, Validator {
     private readonly localeService;
+    /** @description Separador decimal personalizado. Usa o do locale ativo se não informado. */
     decimalSeparator?: string;
+    /** @description Separador de milhar personalizado. Usa o do locale ativo se não informado. */
     thousandsSeparator?: string;
+    /** @description Número máximo de casas decimais aceitas na validação. @default 2 */
     precision: number;
     private numberRegex?;
     constructor(localeService: LocaleService);

package/mask/lib/mask/mask-formatter.pipe.d.ts

@@ -1,5 +1,17 @@
 import { PipeTransform } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Pipe que aplica uma máscara de formatação a uma string,
+ * suportando os tokens `9` (dígito), `a` (letra) e `*` (alfanumérico),
+ * além de suporte a posições opcionais com `?`.
+ *
+ * @example
+ * ```html
+ * {{ '12345678901' | sMaskFormatter:'999.999.999-99' }}
+ * ```
+ *
+ * @category Data
+ */
 export declare class MaskFormatterPipe implements PipeTransform {
     private _defs;
     transform(value: string, maskFormat: string): any;

package/mouse-events/lib/mouse-events/double-click.directive.d.ts

@@ -1,6 +1,19 @@
 import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que detecta duplo clique em um elemento com um intervalo
+ * configurável entre cliques (`_DOUBLE_CLICK_DELAY`). Emite o evento `doubleClicked`
+ * somente quando dois cliques ocorrem dentro do intervalo definido.
+ *
+ * @example
+ * ```html
+ * <div sDoubleClick (doubleClicked)="onDoubleClick($event)">Duplo clique aqui</div>
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class DoubleClickDirective {
+    /** @description Emitido quando um duplo clique é detectado dentro do intervalo de tempo. */
     doubleClicked: EventEmitter<PointerEvent>;
     private _timeout;
     private _DOUBLE_CLICK_DELAY;

package/mouse-events/lib/mouse-events/long-press.directive.d.ts

@@ -1,8 +1,22 @@
-import { EventEmitter, OnDestroy, OnInit } from "@angular/core";
-import { Subject } from "rxjs";
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { Subject } from 'rxjs';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que detecta o gesto de pressão longa (long press) em um elemento.
+ * Emite o evento `sLongPress` após o tempo configurado em `sLongPressDelay` sem que o
+ * botão do mouse ou o toque seja liberado.
+ *
+ * @example
+ * ```html
+ * <button [sLongPressDelay]="800" (sLongPress)="onLongPress($event)">Segurar</button>
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class LongPressDirective implements OnInit, OnDestroy {
+    /** @description Tempo em milissegundos para disparar o long press. @default 500 */
     sLongPressDelay: number;
+    /** @description Emitido quando o elemento é pressionado por mais de `sLongPressDelay` ms. */
     sLongPress: EventEmitter<MouseEvent>;
     mouseUp: Subject<MouseEvent>;
     mouseDown: Subject<MouseEvent>;

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

@@ -4,12 +4,31 @@ import { NavigationButtonItem } from './models/navigation-button-item';
 import { NavigationButtonStepChangedInfo } from './models';
 import { TieredMenuItemData } from '@seniorsistemas/angular-components/tiered-menu';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de navegação por etapas que exibe o estado atual (step)
+ * com suporte a avanço, retrocesso e seleção direta via dropdown (`TieredMenu`).
+ * Implementa `ControlValueAccessor` para integração com formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-navigation-button
+ *   [steps]="etapas"
+ *   (stepChanged)="onEtapaMudou($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class NavigationButtonComponent implements ControlValueAccessor, OnInit, AfterViewInit {
     private readonly changeDetectorRef;
+    /** @description Lista de etapas de navegação. Campo obrigatório. */
     steps: NavigationButtonItem[];
+    /** @description Valor padrão a ser selecionado ao inicializar o componente. */
     defaultValue: unknown;
+    /** @description Texto exibido no tooltip do botão principal. */
     tooltip?: string;
+    /** @description Quando `true`, emite `stepChanged` durante a inicialização com a etapa atual. @default false */
     changeOnInit: boolean;
+    /** @description Emitido quando o usuário navega para uma nova etapa, com informações da etapa anterior e atual. */
     stepChanged: EventEmitter<NavigationButtonStepChangedInfo>;
     currentIndex: number;
     isDisabled: boolean;

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

@@ -10,19 +10,37 @@ export declare enum NumberAlignmentOption {
     LEFT = "left"
 }
 /**
- * @deprecated Should use BigNumberInput directive instead
+ * @deprecated Use a diretiva `BigNumberInput` em vez desta.
+ * @description Diretiva de entrada numérica com formatação localizada (separador decimal
+ * e de milhar), suporte a precisão, escala e alinhamento. Extende `CurrencyMaskDirective`.
+ *
+ * @example
+ * ```html
+ * <input sNumberInput [precision]="10" [scale]="2" />
+ * ```
+ *
+ * @category Inputs
  */
 export declare class NumberInputDirective extends CurrencyMaskDirective implements OnInit, OnChanges, OnDestroy {
     private readonly _elementRef;
     private readonly localeService;
+    /** @description Número total de dígitos (inteiros + decimais). @default 15 */
     precision: number;
+    /** @description Número de casas decimais. @default 0 */
     scale: number;
+    /** @description Separador decimal personalizado. Usa o do locale ativo se não informado. */
     decimalSeparator?: string;
+    /** @description Separador de milhar personalizado. Usa o do locale ativo se não informado. */
     thousandsSeparator?: string;
+    /** @description Alinhamento do texto no campo. @default NumberAlignmentOption.LEFT */
     alignTo: NumberAlignmentOption;
+    /** @description Habilita a entrada de valores negativos. @default true */
     allowNegative: boolean;
+    /** @description Placeholder exibido quando o campo está vazio. */
     placeholder?: string;
+    /** @description Comprimento máximo do valor permitido. */
     maxLength?: number;
+    /** @description Emitido quando o conteúdo colado pelo usuário é rejeitado por ser inválido. */
     pasteRejected: EventEmitter<string>;
     private pasteListener;
     private _maxLength;

package/numeric/lib/numeric.pipe.d.ts

@@ -3,6 +3,21 @@ import { LocaleService } from '@seniorsistemas/angular-components/locale';
 import BigNumber from 'bignumber.js';
 import { NumericService } from './numeric.service';
 import * as i0 from "@angular/core";
+/**
+ * @description Angular pipe for formatting numeric values according to the active locale.
+ * Wraps `NumericService.instant()` and reactively responds to locale changes via `LocaleService`.
+ * Accepts an optional `locale` override and `Intl.NumberFormatOptions` for fine-grained control.
+ *
+ * @example
+ * ```html
+ * <!-- Basic usage -->
+ * {{ 1234.56 | numeric | async }}
+ *
+ * <!-- With locale override and fraction digits -->
+ * {{ 1234.56 | numeric:{ locale: 'en-US', numberFormatOptions: { minimumFractionDigits: 2 } } | async }}
+ * ```
+ * @category Numeric
+ */
 export declare class NumericPipe implements PipeTransform {
     private readonly numericService;
     private readonly localeService;

package/numeric/lib/numeric.service.d.ts

@@ -1,6 +1,26 @@
 import { LocaleService } from '@seniorsistemas/angular-components/locale';
 import BigNumber from 'bignumber.js';
 import * as i0 from "@angular/core";
+/**
+ * @description Service for formatting numeric values using the browser's `Intl.NumberFormat` API.
+ * Automatically uses the locale configured in `LocaleService` unless explicitly overridden.
+ * Supports `BigNumber`, plain numbers, and numeric strings, as well as currency display styles.
+ *
+ * @example
+ * ```typescript
+ * // Inject the service
+ * const numericService = inject(NumericService);
+ *
+ * // Format a number with the active locale
+ * const formatted = numericService.instant(1234567.89);
+ *
+ * // Format as currency
+ * const currency = numericService.instant(1234.5, {
+ *   numberFormatOptions: { style: 'currency', currency: 'BRL' }
+ * });
+ * ```
+ * @category Numeric
+ */
 export declare class NumericService {
     private readonly localeService;
     constructor(localeService: LocaleService);

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

@@ -2,11 +2,11 @@ import { OnInit } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, ValidationErrors, Validator } from '@angular/forms';
 import * as i0 from "@angular/core";
 /**
- * Numeric mask directive with internationalization support.
+ * @description Diretiva de máscara numérica com suporte a internacionalização.
  *
- * Formats numeric values according to the specified locale, applying
- * appropriate thousand and decimal separators, with support for negative values,
- * min/max decimal places control, and scientific notation.
+ * Formata valores numéricos de acordo com o locale especificado, aplicando
+ * separadores de milhar e decimal adequados, com suporte a valores negativos,
+ * controle de casas decimais mín/máx e notação científica.
  *
  * @example
  * ```html
@@ -20,6 +20,7 @@ import * as i0 from "@angular/core";
  *   [(ngModel)]="value"
  * />
  * ```
+ * @category Numeric
  */
 export declare class NumericMaskDirective implements OnInit, ControlValueAccessor, Validator {
     /**

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

@@ -3,17 +3,40 @@ import { ObjectCardFieldComponent } from './elements/field/object-card-field.com
 import { ObjectCardMainComponent } from './elements/main/object-card-main.component';
 import { BorderButtonOptions, Severities } from '@seniorsistemas/angular-components/shared';
 import * as i0 from "@angular/core";
+/**
+ * @description Card de exibição de objeto com setor principal, campos extras e
+ * painel expansível. Calcula automaticamente quantos campos cábem visíveis
+ * conforme a largura do container e suporta nível de severidade.
+ *
+ * @example
+ * ```html
+ * <s-object-card [severity]="'info'" [expanded]="false">
+ *   <s-object-card-main label="Nome" value="João" />
+ *   <s-object-card-field label="CPF" value="000.000.000-00" />
+ * </s-object-card>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class ObjectCardComponent implements AfterContentChecked {
     static readonly nextIdSeed = 0;
     private static _nextId;
     static getNextId(): number;
+    /** @description Identificador do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Define se o painel expansível está aberto. @default false */
     expanded: boolean;
+    /** @description Tooltip do botão de expandir. @default 'Abrir painel' */
     expandTooltip: string;
+    /** @description Tooltip do botão de colapsar. @default 'Fechar painel' */
     collapseTooltip: string;
+    /** @description Largura mínima em pixels de cada campo visível. @default 200 */
     fieldsMinWidth: number;
+    /** @description Nível de severidade que altera o estilo visual. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão de borda lateral. */
     borderButtonOptions?: BorderButtonOptions;
+    /** @description Emitido quando o estado de expansão muda, com o novo valor booleano. */
     expandedChange: EventEmitter<boolean>;
     main: ObjectCardMainComponent | null;
     fields: import("@angular/core").Signal<readonly ObjectCardFieldComponent[]>;

package/optional-fields/editor/editor-field.d.ts

@@ -1,10 +1,29 @@
 import { EnvironmentProviders } from '@angular/core';
 import { FieldConfig } from '@seniorsistemas/angular-components/dynamic-form';
+/**
+ * Configuração fornecida ao instanciar um campo do tipo 'editor'.
+ * Utilizado para renderizar um editor de rich text (wysiwyg).
+ */
 export interface EditorFieldConfig extends FieldConfig {
+    /**
+     * Define o tipo único deste campo opcional.
+     */
     type: 'editor';
+    /**
+     * Formatos suportados pelo editor (ex: 'bold', 'italic').
+     */
     formats?: string[];
+    /**
+     * Define se o editor estará apenas em modo leitura.
+     */
     readonly?: boolean;
+    /**
+     * Módulos adicionais do QuillJS a serem ativados no editor.
+     */
     modules?: any;
+    /**
+     * Estilos customizados aplicados diretamente no container do editor.
+     */
     style?: {
         [klass: string]: unknown;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seniorsistemas/angular-components",
-  "version": "19.0.5",
+  "version": "19.0.6",
   "peerDependencies": {
     "@angular/cdk": "^18.2.14",
     "@angular/common": "^18.2.0",
@@ -53,23 +53,17 @@
       "esm": "./esm2022/autocomplete/seniorsistemas-angular-components-autocomplete.mjs",
       "default": "./fesm2022/seniorsistemas-angular-components-autocomplete.mjs"
     },
-    "./badge": {
-      "types": "./badge/index.d.ts",
-      "esm2022": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
-      "esm": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
-      "default": "./fesm2022/seniorsistemas-angular-components-badge.mjs"
-    },
     "./bignumber-input": {
       "types": "./bignumber-input/index.d.ts",
       "esm2022": "./esm2022/bignumber-input/seniorsistemas-angular-components-bignumber-input.mjs",
       "esm": "./esm2022/bignumber-input/seniorsistemas-angular-components-bignumber-input.mjs",
       "default": "./fesm2022/seniorsistemas-angular-components-bignumber-input.mjs"
     },
-    "./button": {
-      "types": "./button/index.d.ts",
-      "esm2022": "./esm2022/button/seniorsistemas-angular-components-button.mjs",
-      "esm": "./esm2022/button/seniorsistemas-angular-components-button.mjs",
-      "default": "./fesm2022/seniorsistemas-angular-components-button.mjs"
+    "./badge": {
+      "types": "./badge/index.d.ts",
+      "esm2022": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
+      "esm": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
+      "default": "./fesm2022/seniorsistemas-angular-components-badge.mjs"
     },
     "./breadcrumb": {
       "types": "./breadcrumb/index.d.ts",
@@ -77,6 +71,12 @@
       "esm": "./esm2022/breadcrumb/seniorsistemas-angular-components-breadcrumb.mjs",
       "default": "./fesm2022/seniorsistemas-angular-components-breadcrumb.mjs"
     },
+    "./button": {
+      "types": "./button/index.d.ts",
+      "esm2022": "./esm2022/button/seniorsistemas-angular-components-button.mjs",
+      "esm": "./esm2022/button/seniorsistemas-angular-components-button.mjs",
+      "default": "./fesm2022/seniorsistemas-angular-components-button.mjs"
+    },
     "./calendar-mask": {
       "types": "./calendar-mask/index.d.ts",
       "esm2022": "./esm2022/calendar-mask/seniorsistemas-angular-components-calendar-mask.mjs",

package/paginator/lib/paginator/paginator.component.d.ts

@@ -1,10 +1,29 @@
 import { OnDestroy } from '@angular/core';
 import { PageChange, PaginatorInternalButton } from '../models/paginator.models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de paginação standalone que exibe botões de páginas,
+ * seletor de itens por página e navegação para primeira/última página.
+ * Emite `pageChange` a cada mudança de página ou tamanho de página.
+ *
+ * @example
+ * ```html
+ * <s-paginator
+ *   [totalRecords]="total"
+ *   [(rows)]="tamanhoPagina"
+ *   (pageChange)="onPaginaMudou($event)" />
+ * ```
+ *
+ * @category Structure
+ */
 export declare class PaginatorComponent implements OnDestroy {
+    /** @description Número total de registros. Campo obrigatório. */
     totalRecords: import("@angular/core").InputSignal<number>;
+    /** @description Número de itens por página. Suporta two-way binding. @default 10 */
     rows: import("@angular/core").ModelSignal<number>;
+    /** @description Opções do seletor de itens por página. @default [10, 20, 50, 100, 200] */
     rowsPerPageOptions: import("@angular/core").InputSignal<number[]>;
+    /** @description Emitido sempre que a página ou o número de itens por página muda. */
     pageChange: import("@angular/core").OutputEmitterRef<PageChange>;
     private readonly currentPageEffect;
     private readonly MAX_PAGE_BUTTONS;

package/panel/lib/panel/panel.component.d.ts

@@ -1,14 +1,35 @@
-import { AfterContentInit, EventEmitter, QueryList, TemplateRef } from "@angular/core";
-import { BorderButtonOptions, EnumSeverity, Severities } from "@seniorsistemas/angular-components/shared";
-import { TemplateDirective } from "@seniorsistemas/angular-components/template";
+import { AfterContentInit, EventEmitter, QueryList, TemplateRef } from '@angular/core';
+import { BorderButtonOptions, EnumSeverity, Severities } from '@seniorsistemas/angular-components/shared';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de painel com cabeçalho, corpo e rodapé customizáveis
+ * via `TemplateDirective`. Suporta colapsar/expandir com animação, nível de
+ * severidade para estilo visual e botão de borda configurável.
+ *
+ * @example
+ * ```html
+ * <s-panel header="Título" [toggleable]="true" severity="info">
+ *   <p>Conteúdo</p>
+ * </s-panel>
+ * ```
+ *
+ * @category Data
+ */
 export declare class PanelComponent implements AfterContentInit {
+    /** @description Título exibido no cabeçalho do painel. */
     header?: string;
+    /** @description Habilita o botão de toggle para colapsar/expandir o painel. @default false */
     toggleable: boolean;
+    /** @description Define o estado inicial do painel como colapsado. @default false */
     collapsed: boolean;
+    /** @description Nível de severidade que altera o estilo visual do painel. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão de borda lateral do painel. */
     borderButtonOptions?: BorderButtonOptions;
+    /** @description Classes CSS adicionais aplicadas ao elemento raíz do painel. @default '' */
     class: string;
+    /** @description Emitido quando o estado de colapso muda, com o novo valor booleano. */
     collapsedChange: EventEmitter<boolean>;
     templates: QueryList<TemplateDirective> | null;
     headerTemplate: TemplateRef<unknown> | null;

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

@@ -3,11 +3,35 @@ import { TranslateService } from '@ngx-translate/core';
 import { PasswordStrengthPositions } from './types/password-positions';
 import { PasswordStrengths } from './types/password-strengths';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente interno que exibe visualmente os indicadores de força de senha.
+ * Utilizado em conjunto com a diretiva {@link PasswordStrengthDirective} para fornecer
+ * feedback em tempo real enquanto o usuário digita, mostrando três níveis de força
+ * (fraca, média e forte) com títulos e indicadores visuais configuráveis.
+ *
+ * @category Inputs
+ */
 export declare class PasswordStrengthComponent implements OnInit {
     private readonly translate;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como fraca.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.weak`.
+     */
     weakTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como média.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.medium`.
+     */
     mediumTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como forte.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.strong`.
+     */
     strongTitle?: string;
+    /**
+     * @description Descrição complementar exibida abaixo dos indicadores de força,
+     * orientando o usuário sobre os requisitos esperados para a senha. Campo obrigatório.
+     */
     description: string;
     title?: string;
     position: PasswordStrengthPositions;