@seniorsistemas/angular-components 19.0.4 → 19.0.6

package/image-cropper/lib/image-cropper/image-cropper.component.d.ts

@@ -3,30 +3,68 @@ import Cropper from 'cropperjs';
 import { FooterComponent, HeaderComponent } from '@seniorsistemas/angular-components/structure';
 import { ActiveDialog } from '@seniorsistemas/angular-components/dialog';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de recorte de imagem que integra a biblioteca `cropperjs`.
+ * Exibe um dialog com uma área interativa para selecionar, recortar e remover imagens,
+ * suportando razão de aspecto configurável, formato circular e templates de cabeçalho/rodapé.
+ *
+ * @example
+ * ```html
+ * <s-image-cropper
+ *   [(visible)]="dialogAberto"
+ *   [imageSource]="urlDaImagem"
+ *   [aspectRatio]="1"
+ *   (croppedImage)="onCroppedImage($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ImageCropperComponent implements OnInit, OnChanges {
     activeDialog: ActiveDialog | null;
     static nextId: number;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Controla a visibilidade do dialog de corte. @default false */
     visible: boolean;
+    /** @description Título exibido no cabeçalho do dialog. @default 'Recortar imagem' */
     header: string;
+    /** @description Rótulo do botão de confirmar o corte. @default 'Recortar' */
     cropLabel: string;
+    /** @description Rótulo do botão de trocar a imagem. @default 'Trocar' */
     selectAnotherLabel: string;
+    /** @description Rótulo do botão de remover a imagem. @default 'Remover' */
     removeLabel: string;
+    /** @description Rótulo do botão de cancelar. @default 'Cancelar' */
     cancelLabel: string;
+    /** @description Título do empty state quando nenhuma imagem foi selecionada. */
     emptyStateTitle: string;
+    /** @description Rótulo do botão de ação do empty state. @default 'Escolher imagem' */
     emptyStateActionLabel: string;
+    /** @description Classe do ícone exibido no empty state. @default 'fa fa-picture-o' */
     emptyStateIconClass: string;
+    /** @description Razão de aspecto para o recorte (ex.: `1` para quadrado, `16/9`). @default NaN (livre) */
     aspectRatio: number;
+    /** @description Quando `true`, exibe a área de recorte no formato circular. @default false */
     rounded: boolean;
+    /** @description Exibe o botão para trocar a imagem selecionada. @default true */
     allowSelectAnother: boolean;
+    /** @description Exibe o botão para remover a imagem. @default true */
     allowRemove: boolean;
+    /** @description Exibe o botão para cancelar o recorte. @default true */
     allowCancel: boolean;
+    /** @description URL ou base64 da imagem a ser carregada no cropper. */
     imageSource?: string;
+    /** @description Emitido quando o valor de `visible` muda, habilitando two-way binding com `[(visible)]`. */
     visibleChange: EventEmitter<boolean>;
+    /** @description Emitido quando o usuário troca a imagem selecionada. */
     changeImage: EventEmitter<any>;
+    /** @description Emitido com a imagem recortada em formato base64 string. */
     croppedImage: EventEmitter<string>;
+    /** @description Emitido com o `HTMLCanvasElement` resultante do recorte. */
     croppedCanvas: EventEmitter<HTMLCanvasElement>;
+    /** @description Emitido quando o usuário confirma a remoção da imagem. */
     removedImage: EventEmitter<any>;
+    /** @description Emitido quando o usuário cancela o recorte. */
     cancel: EventEmitter<any>;
     image: ElementRef<HTMLImageElement> | null;
     headerSection: HeaderComponent | null;

package/infinite-scroll/lib/infinite-scroll/infinite-scroll.directive.d.ts

@@ -1,7 +1,22 @@
 import { ElementRef, EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva de scroll infinito que detecta quando o usuário chega
+ * ao final do elemento e emite o evento `scrolled`. Deve ser aplicada a um
+ * elemento com overflow e scroll habilitado.
+ *
+ * @example
+ * ```html
+ * <div sInfiniteScroll (scrolled)="carregarMais()" style="overflow-y: auto; height: 400px">
+ *   <!-- itens -->
+ * </div>
+ * ```
+ *
+ * @category Data
+ */
 export declare class InfiniteScrollDirective {
     private readonly el;
+    /** @description Emitido quando o usuário atinge o final do elemento com scroll. */
     scrolled: EventEmitter<number>;
     constructor(el: ElementRef);
     scroll(): void;

package/info-sign/lib/info-sign/info-sign.directive.d.ts

@@ -1,11 +1,40 @@
-import { OnChanges, OnDestroy, OnInit, TemplateRef, ViewContainerRef } from "@angular/core";
+import { OnChanges, OnDestroy, OnInit, TemplateRef, ViewContainerRef } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva estrutural que exibe um ícone de informação ao lado do elemento hospedeiro.
+ * Ao interagir com o ícone, um tooltip com a mensagem configurada é exibido temporariamente.
+ * Suporta sincronização de posição com um campo de input referenciado.
+ *
+ * @example
+ * ```html
+ * <input *sInfoSign="'Informe seu CPF'; displayTime: 4000" type="text" />
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class InfoSignDirective implements OnChanges, OnInit, OnDestroy {
     private readonly templateRef;
     private readonly viewContainer;
+    /**
+     * @description Mensagem exibida no tooltip do ícone de informação. Campo obrigatório.
+     */
     sInfoSign: string;
+    /**
+     * @description Tempo em milissegundos que o tooltip permanece visível após ser exibido.
+     *
+     * @default 5000
+     */
     displayTime: number;
+    /**
+     * @description Referência a um elemento de input HTML para posicionamento relativo do info sign.
+     * Utilizado quando `useFocusedInputRef` é `true`.
+     */
     focusedInputRef: HTMLInputElement | HTMLElement | undefined | null;
+    /**
+     * @description Quando `true`, utiliza `focusedInputRef` para calcular o posicionamento do ícone.
+     *
+     * @default true
+     */
     useFocusedInputRef: boolean;
     private componentRef;
     constructor(templateRef: TemplateRef<any>, viewContainer: ViewContainerRef);

package/inline-edit/lib/inline-edit/inline-edit.component.d.ts

@@ -2,9 +2,24 @@ import { OnInit, ViewContainerRef } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { InlineEditField } from './fields/index';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de edição inline que renderiza dinamicamente campos editáveis
+ * (texto, número, data, textarea, lookup e gerador de conteúdo) a partir de uma lista
+ * de configurações `InlineEditField[]`. Integrado a um `FormGroup` Angular fornecido externamente.
+ *
+ * @example
+ * ```html
+ * <s-inline-edit [formGroup]="form" [fields]="camposEditaveis" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class InlineEditComponent implements OnInit {
+    /** @description `FormGroup` Angular ao qual os campos inline serão vinculados. @default new FormGroup({}) */
     formGroup: FormGroup;
+    /** @description Lista de configurações dos campos inline a serem renderizados. @default [] */
     fields: InlineEditField[];
+    /** @description Mapa de mensagens de erro customizadas por nome de validador. */
     errorMessages?: any;
     container: ViewContainerRef | null;
     ngOnInit(): void;

package/insights/lib/insights/insights.component.d.ts

@@ -4,15 +4,37 @@ import { InsightsSidebarComponent } from './components/insights-sidebar/insights
 import { InsightsItem } from './models/insights-item';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de painel lateral de insights com IA. Exibe uma lista de itens
+ * de insights em um sidebar, suportando templates customizáveis para o conteúdo de
+ * introdução, estado vazio e sem permissão. Também exporta como seletor legado `s-ia-insight`.
+ *
+ * @example
+ * ```html
+ * <s-insights
+ *   [insights]="listaInsights"
+ *   [hasPermission]="true"
+ *   (openInsights)="onAbrir()" />
+ * ```
+ *
+ * @category Structure
+ */
 export declare class InsightsComponent implements AfterContentInit {
+    /** @description Lista de itens de insight a serem exibidos no painel. @default [] */
     insights: InsightsItem[];
+    /** @description Indica se o usuário tem permissão para ver os insights. @default true */
     hasPermission: boolean;
+    /** @description Texto de introdução exibido no topo do painel (quando sem template customizado). */
     introText?: string;
+    /** @description Texto exibido quando não há insights disponíveis. */
     emptyText?: string;
+    /** @description Texto exibido quando o usuário não tem permissão. */
     noPermissionText?: string;
     sidebar: InsightsSidebarComponent | null;
     templates: QueryList<TemplateDirective> | null;
+    /** @description Emitido quando o painel de insights é aberto. */
     openInsights: import("@angular/core").OutputEmitterRef<void>;
+    /** @description Emitido quando o painel de insights é fechado. */
     closedInsights: import("@angular/core").OutputEmitterRef<void>;
     introTemplate: TemplateRef<any> | null;
     emptyTemplate: TemplateRef<any> | null;

package/interactive-content/lib/interactive-content/interactive-content.directive.d.ts

@@ -1,10 +1,30 @@
 import { ElementRef, OnInit, OnDestroy } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva de acessibilidade que torna qualquer elemento HTML interativo,
+ * adicionando suporte a eventos de foco e navegação por teclado (Enter e Espaço)
+ * além do clique padrão. Gerencia automaticamente o atributo `tabindex`.
+ *
+ * @example
+ * ```html
+ * <div
+ *   (sInteractiveContent)="onActivate($event)"
+ *   [focusable]="true">
+ *   Conteúdo interativo
+ * </div>
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class InteractiveContentDirective implements OnInit, OnDestroy {
     private readonly elementRef;
+    /** @description Emitido quando o usuário clica ou pressiona Enter/Espaço no elemento. */
     activated: import("@angular/core").OutputEmitterRef<PointerEvent | KeyboardEvent>;
+    /** @description Habilita o foco via teclado (tabindex). @default true */
     focusable: import("@angular/core").InputSignal<boolean>;
+    /** @description Desabilita os eventos de interação do elemento. @default false */
     disabled: import("@angular/core").InputSignal<boolean>;
+    /** @description Quando `true`, chama `event.stopPropagation()` ao ativar. @default false */
     stopPropagation: import("@angular/core").InputSignal<boolean>;
     private readonly EVENT_LISTENER;
     constructor(elementRef: ElementRef<HTMLElement>);

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 {
     /**