@seniorsistemas/angular-components 19.0.4 → 19.0.6

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

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

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

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

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

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

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

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

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

@@ -2,7 +2,27 @@ import { ControlValueAccessor } from '@angular/forms';
 import { CheckboxListData } from './models/checkbox-list-data';
 import { CheckboxListChildren, CheckboxListState } from './models/checkbox-list-state';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de lista de checkboxes hierárquica, com suporte a estados
+ * pai/filho e indeterminado. Ao marcar/desmarcar o item pai, todos os filhos são
+ * afetados, e o estado do pai é calculado automaticamente com base nos filhos.
+ * Implementa {@link ControlValueAccessor} para uso em formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-checkbox-list
+ *   formControlName="permissoes"
+ *   [data]="estruturaPermissoes" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CheckboxListComponent implements ControlValueAccessor {
+    /**
+     * @description Estrutura de dados que define o item raiz e seus filhos.
+     * Cada `CheckboxListData` pode conter o label, estado inicial e uma lista de filhos recursiva.
+     * Campo obrigatório.
+     */
     data: CheckboxListData;
     state: CheckboxListState;
     private _onChange;

package/chips/lib/chips/chip-item/chip-item.component.d.ts

@@ -1,17 +1,32 @@
 import { EventEmitter, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente interno de item individual de chip, utilizado pelo {@link ChipsComponent}.
+ * Responsável pela renderização do texto, tooltip e botão de remoção de cada chip.
+ *
+ * @category Inputs
+ */
 export declare class ChipItemComponent {
+    /** @description Conteúdo a ser exibido no chip (string ou objeto). Campo obrigatório. */
     dataRender: string | Object;
+    /** @description Chave do objeto usada para exibição quando `dataRender` for um objeto. Campo obrigatório. */
     objectField: string;
+    /** @description Desabilita os eventos de clique do chip. Campo obrigatório. */
     disabled: boolean;
+    /** @description Template personalizado para renderização interna do chip. */
     templateRef: TemplateRef<any> | undefined;
+    /** @description Índice do chip na lista, usado ao emitir o evento de remoção. Campo obrigatório. */
     itemIndex: number;
+    /** @description Habilita o tooltip para chips com texto truncado. Campo obrigatório. */
     showTooltip: boolean;
+    /** @description Limite de caracteres exibidos antes de truncar o texto do chip. Campo obrigatório. */
     maxLengthRenderWithoutTooltip: number;
+    /** @description Emitido ao clicar no botão de remoção do chip. */
     clickRemove: EventEmitter<{
         itemIndex: number;
         event: Event;
     }>;
+    /** @description Emitido ao clicar sobre o chip (fora do botão de remoção). */
     chipClicked: EventEmitter<{
         event: Event;
         data: string | Object;

package/chips/lib/chips/chips/chips.component.d.ts

@@ -3,32 +3,73 @@ import { ControlValueAccessor } from '@angular/forms';
 import { KeyFilterPattern } from 'primeng/keyfilter';
 import { ChipAddEvent } from '../models/chip-models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de entrada de tags/chips que permite adicionar e remover
+ * itens de texto livremente ou a partir de uma lista. Suporta templates personalizados
+ * para renderização de cada chip, filtro de teclas, limite de itens e duplicação configurável.
+ * Implementa {@link ControlValueAccessor} para uso em formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-chips
+ *   formControlName="tags"
+ *   placeholder="Adicionar tag..."
+ *   [max]="10"
+ *   [allowDuplicated]="false"
+ *   (added)="onAdded($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ChipsComponent implements AfterViewInit, ControlValueAccessor {
     private readonly cdr;
     newItem: string;
     chipTemplate?: TemplateRef<any>;
+    /** @description Desabilita a interação com o componente. @default false */
     disabled: boolean;
+    /** @description Chave do objeto usada para exibição quando os itens são objetos complexos. @default '' */
     field: string;
+    /** @description Lista de chips atualmente exibidos. @default [] */
     value: any[];
+    /** @description Texto de placeholder exibido no campo de entrada quando vazio. */
     placeholder: string | undefined;
+    /** @description Número máximo de chips permitidos. @default Infinity */
     max: number;
+    /** @description Comprimento máximo do texto de cada chip. @default Infinity */
     maxLength: number;
+    /** @description Identificador do elemento `<input>` interno. Gerado automaticamente se não informado. */
     inputId: string;
+    /** @description Permite a adição de chips com valor duplicado. @default true */
     allowDuplicated: boolean;
+    /** @description Quando `false`, a comparação de duplicatas é case-insensitive. @default false */
     caseSensitiveDuplication: boolean;
+    /** @description Adiciona o chip ao pressionar Tab. @default true */
     addOnTab: boolean;
+    /** @description Adiciona o chip ao perder o foco (blur). @default true */
     addOnBlur: boolean;
+    /** @description Caractere separador que, quando digitado, confirma a adição de um novo chip. @default '' */
     separator: string;
+    /** @description Coloca o foco automaticamente no campo de entrada ao renderizar o componente. @default false */
     autofocus: boolean;
+    /** @description Texto informativo exibido abaixo do campo de entrada. @default '' */
     infoLabel: string;
+    /** @description Expressão regular ou padrão predefinido (PrimeNG KeyFilterPattern) para filtrar teclas aceitas. */
     keyFilter?: RegExp | KeyFilterPattern;
+    /** @description Exibe tooltip ao passar o mouse sobre chips com texto truncado. @default true */
     showTooltip: boolean;
+    /** @description Número máximo de caracteres exibidos diretamente no chip sem aplicar truncamento. @default 20 */
     maxLengthRenderWithoutTooltip: number;
+    /** @description Emitido quando um novo chip é adicionado com sucesso. */
     added: EventEmitter<ChipAddEvent>;
+    /** @description Emitido quando um chip é removido pelo usuário. */
     removed: EventEmitter<import("../models/chip-models").ChipEvent>;
+    /** @description Emitido quando o campo de entrada recebe foco. */
     focused: EventEmitter<FocusEvent>;
+    /** @description Emitido quando o campo de entrada perde o foco. */
     focusLost: EventEmitter<FocusEvent>;
+    /** @description Emitido quando o usuário clica em um chip existente. */
     chipClicked: EventEmitter<import("../models/chip-models").ChipEvent>;
+    /** @description Emitido sempre que a lista de chips é alterada (adição ou remoção). */
     valueChange: EventEmitter<any[] | string[]>;
     private readonly templates;
     private readonly input;

package/code-editor/lib/code-editor/code-editor.component.d.ts

@@ -3,15 +3,55 @@ import { ControlValueAccessor } from '@angular/forms';
 import { CoreFacade } from './core/facades/core-facade';
 import { EditorOptions } from './models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de editor de código com syntax highlighting, construído sobre
+ * um editor Monaco/CodeMirror. Implementa {@link ControlValueAccessor} para integração
+ * com formulários Angular e suporta configuração de linguagem, tema e opções avançadas
+ * do editor via `editorOptions`.
+ *
+ * @example
+ * ```html
+ * <s-code-editor
+ *   formControlName="script"
+ *   [editorOptions]="{ language: 'javascript', theme: 'vs-dark' }"
+ *   (codeChange)="onCodeChange($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CodeEditorComponent implements OnInit, AfterViewInit, ControlValueAccessor, OnDestroy {
     private readonly coreFacade;
+    /**
+     * @description Opções de configuração do editor (linguagem, tema, readonly, etc.).
+     * Ao atribuir um novo valor, as opções são aplicadas imediatamente ao editor.
+     */
     set editorOptions(options: EditorOptions | undefined);
+    /**
+     * @description Conteúdo textual do editor. Ao atribuir, o código é propagado ao núcleo do editor.
+     */
     set code(code: string);
+    /**
+     * @description Indica se o código atual é válido segundo as regras do editor.
+     * Pode ser usado para exibir indicadores visuais de erro.
+     *
+     * @default false
+     */
     isCodeValid: boolean | undefined;
+    /**
+     * @description Payload adicional passado ao núcleo do editor, utilizado para
+     * contexto de autocompletar ou validações específicas da linguagem.
+     */
     set payload(payload: string);
+    /** @description Emitido sempre que o conteúdo do editor é alterado. Emite o código atual como string. */
     codeChange: EventEmitter<string>;
+    /** @description Emitido quando o estado de validade do código muda. */
     isCodeValidChange: EventEmitter<boolean>;
+    /**
+     * @deprecated Use `codeChange` ao invés deste output.
+     * @description Emitido sempre que o conteúdo do editor é alterado.
+     */
     onCodeChange: EventEmitter<string>;
+    /** @description Emitido quando o componente finaliza o carregamento e o editor está pronto para uso. */
     onComponentFinishLoad: EventEmitter<void>;
     private readonly coreWrapperElement;
     private readonly _ngUnsubscribe;

package/collapse-link/lib/collapse-link/collapse-link.component.d.ts

@@ -1,13 +1,31 @@
 import { OnChanges, SimpleChanges } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de link expansor que mostra/oculta conteúdo transclusão
+ * com animação de colapso. Exibe rótulos diferentes para os estados expandido e colapsado.
+ *
+ * @example
+ * ```html
+ * <s-collapse-link expandedLabel="Ver menos" collapsedLabel="Ver mais">
+ *   <p>Conteúdo oculto</p>
+ * </s-collapse-link>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class CollapseLinkComponent implements OnChanges {
     static readonly nextIdSeed = 0;
     private static _nextId;
     static getNextId(): number;
+    /** @description Identificador do botão de toggle. Gerado automaticamente se não informado. */
     buttonId: string;
+    /** @description Rótulo exibido quando o conteúdo está expandido. @default 'Mostrar menos' */
     expandedLabel: string;
+    /** @description Rótulo exibido quando o conteúdo está colapsado. @default 'Mostrar mais' */
     collapsedLabel: string;
+    /** @description Desabilita o botão de toggle. @default false */
     disabled: boolean;
+    /** @description Controla externamente o estado colapsado do componente. @default true */
     collapse: boolean;
     collapsed: boolean;
     animating: boolean;

package/common/lib/svg-factory/components/iassist-icon/iassist-icon.component.d.ts

@@ -1,4 +1,9 @@
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de ícone do IAssist, exibido a partir de um template SVG externo.
+ *
+ * @category Common
+ */
 export declare class IAssistIconComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<IAssistIconComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<IAssistIconComponent, "ng-component", never, {}, {}, never, never, false, never>;

package/confirm-dialog/lib/popup-confirm-dialog/popup-confirm-dialog.component.d.ts

@@ -1,5 +1,24 @@
 import { ConfirmDialog } from '../confirm-dialog.model';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente interno do diálogo de confirmação, renderizado pelo `ConfirmDialogService`.
+ * Exibe uma janela modal com uma mensagem, título e botões de aceitar e rejeitar configuráveis.
+ * Não deve ser instanciado diretamente; utilize `ConfirmDialogService.open()` para exibi-lo.
+ *
+ * @example
+ * ```ts
+ * // Uso via serviço
+ * this.confirmDialogService.open({
+ *   header: 'Confirmar exclusão',
+ *   message: 'Deseja realmente excluir este item?',
+ *   acceptLabel: 'Excluir',
+ *   rejectLabel: 'Cancelar',
+ *   accept: () => this.delete(),
+ * });
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class PopupConfirmDialogComponent {
     confirmDialog: ConfirmDialog;
     static ɵfac: i0.ɵɵFactoryDeclaration<PopupConfirmDialogComponent, never>;

package/content-generator/lib/content-generator/content-generator.component.d.ts

@@ -7,6 +7,24 @@ import { TextAreaComponent } from '@seniorsistemas/angular-components/text-area'
 import { IAssistService } from '../services/IAssist/iassist.service';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de área de texto com geração de conteúdo por inteligência artificial.
+ * Integra-se ao serviço IAssist para sugerir e completar textos com base em um prompt configurável.
+ * Suporta reconhecimento de voz opcional e mantém contexto entre gerações quando `keepContext` é `true`.
+ * Implementa {@link ControlValueAccessor} para uso em formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-content-generator
+ *   formControlName="descricao"
+ *   label="Descrição"
+ *   prompt="Gere uma descrição para o produto"
+ *   [rows]="5"
+ *   [speechRecognition]="true" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ContentGeneratorComponent implements OnInit, ControlValueAccessor {
     private readonly _iassistService;
     private readonly _formBuilder;
@@ -15,17 +33,29 @@ export declare class ContentGeneratorComponent implements OnInit, ControlValueAc
     private injector;
     textArea: import("@angular/core").Signal<TextAreaComponent | undefined>;
     private static id;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Label exibido acima da área de texto. */
     label: string;
+    /** @description Texto de placeholder exibido na área de texto quando vazia. @default '' */
     placeholder: string;
+    /** @description Instrução (prompt) enviada ao serviço de IA para gerar o conteúdo sugerido. */
     prompt: string;
+    /** @description Torna a área de texto somente leitura. @default false */
     readonly: boolean;
+    /** @description Número de linhas visíveis da área de texto. @default 10 */
     rows: number;
+    /** @description Número de colunas visíveis da área de texto. @default 10 */
     cols: number;
+    /** @description Habilita o botão de reconhecimento de voz para ditado de texto. @default false */
     speechRecognition: boolean;
+    /** @description Quando `true`, o histórico de gerações anteriores é enviado ao serviço de IA como contexto. @default false */
     keepContext: boolean;
+    /** @description Texto de placeholder exibido no campo de reconhecimento de voz. @default '' */
     speechRecognitionPlaceholder: string;
+    /** @description Limite máximo de caracteres permitidos na área de texto. `null` desabilita o limite. @default null */
     maxLength: number | null;
+    /** @description Estilos CSS inline aplicados à área de texto interna. */
     textAreaStyle: import("@angular/core").InputSignal<Partial<CSSStyleDeclaration>>;
     formGroup: FormGroup;
     contextForm: FormGroup;

package/control-errors/lib/control-errors/control-errors.component.d.ts

@@ -5,15 +5,51 @@ type ErrorMessageType = {
     id: string;
     message: string;
 };
+/**
+ * @description Componente que exibe as mensagens de erro de validação associadas a um controle de formulário.
+ * Observa as alterações de estado do controle e renderiza as mensagens mapeadas em `errorMessages`.
+ * Compativel com `AbstractControl` do Reactive Forms e `NgModel` do Template-Driven Forms.
+ *
+ * @example
+ * ```html
+ * <s-control-errors
+ *   [control]="form.get('email')"
+ *   [errorMessages]="{ required: 'E-mail obrigatório', email: 'E-mail inválido' }"
+ * />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class ControlErrorsComponent implements OnDestroy, OnChanges {
     static readonly nextIdSeed = 0;
     private static readonly RANDOM_ID_END_INDEX;
     private static readonly BASE_36;
     private static _nextId;
     static getNextId(): number;
+    /**
+     * @description Identificador único do componente. Gerado automaticamente se não informado.
+     * Usado para associação acessível com o campo correspondente.
+     */
     id: string;
+    /**
+     * @description Controle do formulário cujos erros serão exibidos.
+     * Aceita `AbstractControl` (Reactive Forms) ou `NgModel` (Template-Driven Forms). Campo obrigatório.
+     */
     control: AbstractControl | NgModel;
+    /**
+     * @description Mapa de chaves de erro para mensagens de texto exibidas ao usuário.
+     * Cada chave corresponde a um erro que pode estar presente em `control.errors`.
+     *
+     * @example
+     * ```ts
+     * { required: 'Campo obrigatório', minlength: 'Mínimo 8 caracteres' }
+     * ```
+     */
     errorMessages: any;
+    /**
+     * @description Referência ao formulário pai. Utilizado em cenários de validação customizada
+     * que dependem do estado geral do formulário.
+     */
     form: any;
     errorMessagesList: ErrorMessageType[];
     private readonly onDestroy$;

package/country-phone-picker/lib/country-phone-picker/country-phone-picker.component.d.ts

@@ -6,14 +6,50 @@ import { CountryPhoneData } from './models/country-phone-data';
 import { Ordination } from './models/ordination';
 import { PhoneSelectionData } from './models/phone-selection-data';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente seletor de país e número de telefone com máscara dinâmica.
+ * Exibe uma lista de países com seus códigos DDI e aplica automaticamente a máscara
+ * de formatação do número conforme o país selecionado. Implementa {@link ControlValueAccessor}
+ * para integração com formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-country-phone-picker
+ *   formControlName="telefone"
+ *   [countries]="['BR', 'US', 'AR']"
+ *   (selected)="onPaisSelecionado($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CountryPhonePickerComponent implements OnInit, ControlValueAccessor {
     private readonly _countryPhonePickerService;
     private readonly _translate;
     private readonly _eRef;
     private readonly platformId;
+    /**
+     * @description Lista de códigos de país (ISO 3166-1 alpha-2) exibidos no seletor.
+     * Quando vazia, todos os países disponíveis são listados.
+     *
+     * @default []
+     */
     countries: string[];
+    /**
+     * @description Critério de ordenação dos países na lista.
+     * Aceita os valores do enum `Ordination` (ex.: por nome, por DDI, sem ordenação).
+     *
+     * @default Ordination.NO
+     */
     ordination: Ordination;
+    /**
+     * @description Emitido quando o usuário seleciona um país no dropdown.
+     * Emite um objeto {@link CountryPhoneData} com dados do país escolhido.
+     */
     selected: EventEmitter<CountryPhoneData>;
+    /**
+     * @description Emitido quando o campo de número de telefone perde o foco.
+     * Emite o objeto {@link PhoneSelectionData} com país e número atuais, ou `null`.
+     */
     focusLost: EventEmitter<PhoneSelectionData | null>;
     phoneInput: ElementRef | null;
     private readonly filterInput;

package/currency/lib/currency.service.d.ts

@@ -1,6 +1,19 @@
-import { Currency } from "./types/currency";
-import { LocaleService } from "@seniorsistemas/angular-components/locale";
+import { Currency } from './types/currency';
+import { LocaleService } from '@seniorsistemas/angular-components/locale';
 import * as i0 from "@angular/core";
+/**
+ * @description Service for retrieving localized currency symbols using the browser's `Intl.NumberFormat` API.
+ * Uses the locale configured in `LocaleService` to format currency parts and extract the symbol.
+ *
+ * @example
+ * ```typescript
+ * const currencyService = inject(CurrencyService);
+ *
+ * // Get the symbol for BRL in the active locale
+ * const symbol = currencyService.getCurrencySymbol({ currency: 'BRL' }); // 'R$'
+ * ```
+ * @category Currency
+ */
 export declare class CurrencyService {
     private readonly localeService;
     constructor(localeService: LocaleService);

package/custom-fields/lib/custom-fields/custom-fields.component.d.ts

@@ -8,24 +8,55 @@ import { LocaleService } from '@seniorsistemas/angular-components/locale';
 import { CustomFieldsService } from './custom-fields.service';
 import { CustomFieldsResponse } from './models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente que carrega e renderiza campos customizados dinamicamente
+ * a partir da API de customização de campos do Senior. Realiza chamadas HTTP para
+ * obter a configuração dos campos, gera o formulário reativamente via {@link DynamicFormComponent}
+ * e implementa {@link ControlValueAccessor} e {@link Validator} para integração completa
+ * com formulários Angular.
+ *
+ * @example
+ * ```html
+ * <s-custom-fields
+ *   formControlName="camposCustomizados"
+ *   domain="plataforma"
+ *   service="servico"
+ *   entity="entidade" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class CustomFieldsComponent implements OnInit, OnDestroy, ControlValueAccessor, Validator, OnChanges, AfterViewInit {
     private readonly customFieldsService;
     private readonly localeService;
     private readonly sanitizer;
     private readonly translateService;
     private readonly controlContainer;
+    /** @description Domínio utilizado para buscar os campos customizados na API. Campo obrigatório. */
     domain: string;
+    /** @description Nome do serviço utilizado para identificar os campos customizados. Campo obrigatório. */
     service: string;
+    /** @description Nome da entidade para a qual os campos customizados são carregados. Campo obrigatório. */
     entity: string;
+    /** @description Mensagem de erro exibida quando algum campo customizado está inválido. @default '' */
     invalidErrorLabel: string;
+    /** @description Objeto com dados pré-carregados da entidade, evitando chamadas extras à API. */
     entityObject?: CustomFieldsResponse;
+    /** @description Endpoint para buscar a configuração dos campos customizados. */
     customFieldsEndpoint: string;
+    /** @description Endpoint para solicitar o upload de arquivos em campos do tipo blob. */
     fileLocationEndpoint: string;
+    /** @description Endpoint para solicitar acesso a arquivos já enviados. */
     requestAccessEndpoint: string;
+    /** @description Mensagem de erro exibida quando um campo obrigatório não está preenchido. @default '' */
     requiredErrorMessage: string;
+    /** @description Tempo em ms após o qual o info-sign de campos do tipo data é exibido. @default 0 */
     displayTimeInfoSign: number;
+    /** @description Exibe a data de upload nos campos do tipo arquivo. @default false */
     showFileUploadDate: boolean;
+    /** @description Observable que sinaliza quando o componente deve iniciar o carregamento dos campos. @default null */
     ready$: BehaviorSubject<boolean> | null;
+    /** @description Quando `true`, todos os campos customizados são desabilitados. */
     disableFields: boolean | undefined;
     protected rowType: StructureType;
     fields: DynamicType[];