@seniorsistemas/angular-components 19.0.5 → 19.0.7

package/dynamic-form/dynamic-form/configurations/structure/row.d.ts

@@ -4,25 +4,75 @@ import { AbstractControl } from '@angular/forms';
 import { FieldSizeConfig } from '../../form-field/configurations/field-size';
 import { DynamicType } from '../../form-field/configurations/fields/field';
 import { DynamicStructure } from '../structure/structure';
+/**
+ * Propriedades adicionais disponíveis em **todo campo ou estrutura colocado dentro de um `row`**.
+ *
+ * Ao inserir um campo em `RowConfig.fields`, ele é expandido com estas propriedades via
+ * `ExpandedDynamicType` / `ExpandedDynamicStructure`. Permitem controlar layout, visibilidade,
+ * mensagens de erro e rodapés de forma granular por campo dentro da linha.
+ */
 interface RowAdditionalFields {
+    /**
+     * Tamanho (largura) deste campo dentro da linha.
+     * Permite definir colunas responsivas (ex: metade da linha, terço, etc.)
+     * usando `FieldSizeConfig` com breakpoints.
+     */
     size?: FieldSizeConfig;
+    /**
+     * Função que retorna `true` quando o campo deve ser exibido.
+     * Permite ocultar/exibir o campo dinamicamente sem removê-lo da configuração.
+     * @example () => this.model.mostrarCampo
+     */
     visible?: () => boolean;
+    /**
+     * Função que retorna um mapa de mensagens de erro customizadas para o campo.
+     * A chave é o nome do validador (ex: `'required'`, `'minlength'`) e o valor é a mensagem.
+     * @example () => ({ required: 'Campo obrigatório', minlength: 'Mínimo 3 caracteres' })
+     */
     errorMessages?: () => {} | {};
+    /**
+     * Template Angular (`ng-template`) renderizado abaixo do campo.
+     * Use para adicionar conteúdo customizado abaixo do input, como dicas ou informações extras.
+     */
     bottomTemplate?: TemplateRef<Element>;
+    /**
+     * Rodapé exibido abaixo do campo com texto de ajuda e/ou link de ação.
+     * Permite adicionar orientações contextuais ou atalhos diretamente associados ao campo.
+     */
     footer?: {
+        /**
+         * Texto de ajuda exibido no rodapé do campo.
+         */
         help?: {
+            /** Texto de ajuda exibido no rodapé. */
             text: string;
+            /**
+             * Função que controla a visibilidade do texto de ajuda.
+             * Recebe o `AbstractControl` e a configuração do campo.
+             */
             visible?: (options: {
                 abstractControl: AbstractControl;
                 formField: DynamicType;
             }) => boolean;
         };
+        /**
+         * Link clicável exibido no rodapé do campo.
+         */
         link?: {
+            /** Texto exibido no link. */
             label: string;
+            /**
+             * Callback chamado ao clicar no link do rodapé.
+             * Recebe o `AbstractControl` e a configuração do campo.
+             */
             onClick?: (options: {
                 abstractControl: AbstractControl;
                 formField: DynamicType;
             }) => void;
+            /**
+             * Função que controla a visibilidade do link.
+             * Recebe o `AbstractControl` e a configuração do campo.
+             */
             visible?: (options: {
                 abstractControl: AbstractControl;
                 formField: DynamicType;
@@ -33,9 +83,26 @@ interface RowAdditionalFields {
 export type ExpandedDynamicType = DynamicType & RowAdditionalFields;
 export type ExpandedDynamicStructure = DynamicStructure & RowAdditionalFields;
 export type RowType = ExpandedDynamicType | ExpandedDynamicStructure;
+/**
+ * Configuração para estrutura do tipo linha (row).
+ *
+ * Organiza campos lado a lado em uma linha horizontal usando grid layout.
+ * Cada campo dentro de um `row` pode receber propriedades adicionais de `RowAdditionalFields`,
+ * como `size`, `visible`, `errorMessages`, `footer` e `bottomTemplate`.
+ */
 export interface RowConfig {
+    /** Tipo da estrutura: sempre `'row'`. */
     type: 'row';
+    /**
+     * Lista de campos e sub-estruturas dispostos em linha.
+     * Cada item pode ter propriedades adicionais de `RowAdditionalFields` (size, visible, footer, etc.).
+     */
     fields: RowType[];
+    /**
+     * Controla a visibilidade da linha inteira.
+     * Pode ser um booleano estático ou função reativa.
+     * @example () => this.model.mostrarSecao
+     */
     visible?: booleanFn | boolean;
 }
 declare module '../structure/structure' {

package/dynamic-form/dynamic-form/configurations/structure/section.d.ts

@@ -1,5 +1,13 @@
 import { StructureConfig } from './structure';
+/**
+ * Configuração para estrutura do tipo seção.
+ *
+ * É o container principal do DynamicForm, agrupa campos e outras estruturas.
+ * Suporta layout flexbox para controlar disposição dos filhos com `isFlex`,
+ * `justifyContent` e `alignItems`.
+ */
 export interface SectionConfig extends StructureConfig {
+    /** Tipo da estrutura: sempre `'section'`. */
     type: 'section';
     /**
      * Define if the structure is a flex container.

package/dynamic-form/dynamic-form/configurations/structure/structure.d.ts

@@ -1,7 +1,26 @@
 import { DynamicType } from '../../form-field/configurations/fields/field';
+/**
+ * Configuração base compartilhada por **todos** os tipos de estrutura do DynamicForm.
+ *
+ * Estruturas são contêineres que agrupam campos e outras estruturas.
+ * Os tipos disponíveis são: `'section'`, `'row'`, `'fieldset'`.
+ */
 export interface StructureConfig {
+    /**
+     * Tipo da estrutura. Deve ser um dos valores registrados em `StructureTypeMap`.
+     * Valores disponíveis: `'section'`, `'row'`, `'fieldset'`.
+     */
     type: StructureType;
+    /**
+     * Lista de campos e sub-estruturas contidas nesta estrutura.
+     * Cada item pode ser um `DynamicType` (campo) ou `DynamicStructure` (estrutura aninhada).
+     * @example [{ type: 'string', name: 'nome', label: 'Nome' }]
+     */
     configs: (DynamicType | DynamicStructure)[];
+    /**
+     * Título opcional exibido no cabeçalho da estrutura.
+     * Usado, por exemplo, como título de seções ou fieldsets.
+     */
     header?: string;
 }
 export interface StructureTypeMap {

package/dynamic-form/dynamic-form/dynamic-form.component.d.ts

@@ -2,16 +2,36 @@ import { FormGroup } from '@angular/forms';
 import { DynamicStructure } from './configurations/structure/structure';
 import { DynamicType } from './form-field/configurations/fields/field';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de formulário dinâmico que renderiza campos configuráveis
+ * a partir de uma estrutura de dados (`DynamicStructure[]` ou `DynamicType[]`).
+ * Suporta múltiplos tipos de campo (texto, número, select, data, arquivo, etc.)
+ * e integra-se a um `FormGroup` Angular existente.
+ *
+ * @example
+ * ```html
+ * <s-dynamic-form
+ *   [form]="meuFormGroup"
+ *   [configs]="estruturaDoCampos" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class DynamicFormComponent {
+    /** @description Identificador único do formulário dinâmico no DOM. */
     id: import("@angular/core").InputSignal<string | undefined>;
+    /** @description Lista de estruturas de campos dinâmicos a serem renderizados. @default [] */
     configs: import("@angular/core").InputSignal<DynamicStructure[]>;
     /**
-     * @deprecated Use `configs` input instead. Este campo será removido em versões futuras.
+     * @deprecated Use o input `configs` ao invés deste. Será removido em versões futuras.
+     * @description Lista legada de campos dinâmicos no formato `DynamicType[]`.
      */
     fields: import("@angular/core").InputSignal<DynamicType[] | undefined>;
     private dynamicTypeToStructure;
     conf: import("@angular/core").Signal<DynamicStructure[] | undefined>;
+    /** @description `FormGroup` Angular ao qual os campos dinâmicos serão vinculados. Campo obrigatório. */
     form: import("@angular/core").InputSignal<FormGroup<any>>;
+    /** @description Mapa de mensagens de erro customizadas por nome de validador, aplicadas globalmente aos campos do formulário. @default {} */
     errorMessages: import("@angular/core").InputSignal<any>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFormComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFormComponent, "s-dynamic-form", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "configs": { "alias": "configs"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": true; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;

package/dynamic-form/dynamic-form/form-field/configurations/fields/autocomplete-field.d.ts

@@ -1,17 +1,62 @@
 import { Observable } from 'rxjs';
 import { FieldConfig } from './field';
+/**
+ * Configuração para campo de autocompletar.
+ *
+ * Exibe um input de texto que sugere opções enquanto o usuário digita, buscando os dados
+ * via Observable. Suporta seleção simples ou múltipla e personalização do campo exibido.
+ */
 export interface AutocompleteFieldConfig extends FieldConfig {
+    /** Tipo do campo: sempre `'autocomplete'`. */
     type: 'autocomplete';
+    /**
+     * Chave única de cada item da lista de sugestões. Usada para identificar o objeto selecionado.
+     * @example 'id'
+     */
     dataKey?: string;
+    /**
+     * Nome da propriedade do objeto de sugestão que será exibida como texto na lista e no input.
+     * @example 'nome'
+     */
     displayField?: string;
+    /**
+     * Quando `true`, permite seleção de múltiplos itens exibidos como tags/chips.
+     */
     multiple?: boolean;
+    /**
+     * Elemento DOM ao qual o painel de sugestões será anexado.
+     * Use `'body'` para evitar problemas de overflow em containers com `overflow: hidden`.
+     */
     appendTo?: string;
+    /**
+     * Mensagem exibida quando nenhuma sugestão é encontrada para o texto digitado.
+     */
     emptyMessage?: string;
+    /**
+     * Observable que emite a lista de sugestões em resposta à digitação do usuário.
+     * Deve emitir um array de objetos com pelo menos a propriedade `displayField`.
+     */
     suggestionsObservable?: Observable<any>;
+    /**
+     * Callback chamado quando o usuário seleciona um item da lista de sugestões.
+     */
     onSelect?: (event: any) => void;
+    /**
+     * Callback chamado quando o usuário remove um item selecionado (modo múltiplo).
+     */
     onUnselect?: (event: any) => void;
+    /**
+     * Callback chamado quando o usuário limpa o campo.
+     */
     onClear?: (event: any) => void;
+    /**
+     * Callback chamado a cada alteração no texto digitado. Use para disparar a busca de sugestões.
+     * @example (value) => this.loadSuggestions(value)
+     */
     onSearch?: (value: string) => void;
+    /**
+     * Callback chamado quando o campo perde o foco.
+     */
     onBlur?: (event: FocusEvent) => void;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/bignumber-field.d.ts

@@ -2,21 +2,80 @@ import { NumberLocaleOptions } from '@seniorsistemas/angular-components/locale';
 import { AddonConfig } from '../../addon-config';
 import { FieldConfig } from './field';
 type stringFn = () => string;
+/**
+ * Configuração para campos numéricos de grande precisão.
+ *
+ * Use `type: 'number'` para números inteiros ou decimais genéricos.
+ * Use `type: 'double'` para números com casas decimais explícitas.
+ *
+ * Suporta controle de precisão, escala, máscaras, addons laterais e formatação regional.
+ * Preferível em relação ao `NumberFieldConfig` (deprecated).
+ */
 export interface BignumberFieldConfig extends FieldConfig {
+    /**
+     * `'number'` — campo numérico genérico (inteiro ou decimal).
+     * `'double'` — campo numérico com casas decimais.
+     */
     type: 'number' | 'double';
+    /**
+     * Permite a entrada de valores negativos.
+     * @default false
+     */
     allowNegative?: boolean;
+    /**
+     * Opções de localização para formatação do número (separador decimal, separador de milhar).
+     * Se omitido, usa o locale padrão da aplicação.
+     */
     numberLocaleOptions?: NumberLocaleOptions;
+    /**
+     * Controla o autocomplete nativo do browser.
+     */
     browserAutocomplete?: boolean;
+    /**
+     * Número total de dígitos (inteiros + decimais). Pode ser uma função para controle dinâmico.
+     */
     precision?: Function | number;
+    /**
+     * Número de casas decimais permitidas. Pode ser uma função para controle dinâmico.
+     */
     scale?: Function | number;
+    /**
+     * Máscara de entrada. Pode ser uma string fixa ou função que retorna a máscara.
+     */
     mask?: stringFn | string;
+    /**
+     * Addon exibido à esquerda do campo (ex: símbolo de moeda, unidade de medida).
+     */
     leftAddon?: AddonConfig;
+    /**
+     * Addon exibido à direita do campo (ex: unidade de medida, botão).
+     */
     rightAddon?: AddonConfig;
+    /**
+     * Callback chamado quando o campo perde o foco.
+     */
     onBlur?: (event: Event) => void;
+    /**
+     * Callback chamado quando o campo recebe foco.
+     */
     onFocus?: (event: FocusEvent) => void;
+    /**
+     * Callback chamado quando a máscara é completamente preenchida.
+     */
     onComplete?: (event: FocusEvent) => void;
+    /**
+     * Callback chamado a cada alteração no valor do input.
+     */
     onInput?: (event: FocusEvent) => void;
+    /**
+     * Quando `true`, limpa o valor do campo automaticamente ao perder o foco se o valor for inválido.
+     */
     autoClear?: boolean;
+    /**
+     * Alinhamento do texto dentro do campo.
+     * `'left'` — alinhado à esquerda (padrão).
+     * `'right'` — alinhado à direita (comum em campos monetários).
+     */
     alignTo?: 'left' | 'right';
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/blob-field.d.ts

@@ -1,24 +1,79 @@
 import { ElementRef } from '@angular/core';
 import { FileDto } from '@seniorsistemas/angular-components/file-picker';
 import { FieldConfig } from './field';
+/**
+ * Configuração para campo de upload de arquivos binários.
+ *
+ * Exibe uma área de upload com suporte a múltiplos arquivos, progresso de envio,
+ * visualização de arquivos enviados e download.
+ *
+ * Todas as propriedades são obrigatórias, pois o componente depende de labels e handlers
+ * para opções de ação e controle dos arquivos.
+ */
 export interface BlobFieldConfig extends FieldConfig {
+    /** Tipo do campo: sempre `'blob'`. */
     type: 'blob';
+    /**
+     * Tipos de arquivo aceitos no seletor de arquivo nativo (MIME types ou extensões).
+     * @example 'image/*' | '.pdf,.docx'
+     */
     accept: string;
+    /**
+     * Lista dos arquivos atualmente associados ao campo.
+     * Deve ser inicializada como array vazio `[]` ao criar o formulário.
+     */
     files: FileDto[];
+    /**
+     * Rótulo do botão de escolher/adicionar arquivo.
+     * @example 'Escolher arquivo'
+     */
     chooseLabel: string;
+    /**
+     * Rótulo do botão de remover um arquivo da lista.
+     * @example 'Remover'
+     */
     removeLabel: string;
+    /**
+     * Rótulo do botão de cancelar o upload em andamento.
+     * @example 'Cancelar'
+     */
     cancelLabel: string;
+    /**
+     * Texto do tooltip exibido quando o upload é concluído com sucesso.
+     * @example 'Upload concluído'
+     */
     successTooltip: string;
+    /**
+     * Permite selecionar e enviar múltiplos arquivos simultaneamente.
+     */
     multiple: boolean;
+    /**
+     * Callback chamado após o envio bem-sucedido de arquivos.
+     * Recebe a lista de arquivos enviados e a instância da configuração do campo.
+     */
     onUploadFile: (event: {
         files: FileDto[];
     }, field: BlobFieldConfig) => void;
+    /**
+     * Callback chamado quando o usuário remove um arquivo da lista.
+     */
     onRemoveFile: (event: FileDto, field: BlobFieldConfig) => void;
+    /**
+     * Callback chamado quando o usuário cancela um upload em andamento.
+     * O `event` é o índice do arquivo na fila de upload.
+     */
     onCancelUpload: (event: number, field: BlobFieldConfig) => void;
+    /**
+     * Callback chamado quando o usuário clica para baixar um arquivo já enviado.
+     * Recebe o índice do arquivo e a referência ao elemento anchor de download.
+     */
     onDownloadFile: (event: {
         index: number;
         anchor: ElementRef;
     }, field: BlobFieldConfig) => void;
+    /**
+     * Quando `true`, exibe a data de upload de cada arquivo na lista.
+     */
     showFileUploadDate: boolean;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/boolean-field.d.ts

@@ -1,17 +1,52 @@
 import { FieldConfig } from './field';
+/**
+ * Labels das opções exibidas no campo booleano de rádio (sim/não/não informado).
+ */
 export interface BooleanOptionsLabelConfig {
+    /** Label exibida para o valor `true`. @example 'Sim' */
     true: string;
+    /** Label exibida para o valor `false`. @example 'Não' */
     false: string;
+    /** Label exibida quando o valor é `null`/`undefined` (não selecionado). @example 'Não informado' */
     empty?: string;
+    /** Label do botão de limpar a seleção. @example 'Limpar' */
     clear?: string;
 }
+/**
+ * Configuração para campo booleano com exibição como botões de rádio (Sim/Não).
+ *
+ * Exibe dois (ou três, com `showClear`) botões de rádio rotulados conforme `optionsLabel`.
+ * Diferente do `booleanSwitch`, este campo é mais adequado para questionários e formulários
+ * que precisam de rotação explícita entre as opções sim/não.
+ */
 export interface BooleanFieldConfig extends FieldConfig {
+    /** Tipo do campo: sempre `'boolean'`. */
     type: 'boolean';
+    /**
+     * Quando `true`, os botões são empilhados verticalmente em vez de na horizontal.
+     */
     verticalAlignment?: boolean;
+    /**
+     * Labels exibidas para as opções do campo. Obrigatório.
+     * @example { true: 'Sim', false: 'Não', empty: 'Não informado', clear: 'Limpar' }
+     */
     optionsLabel: BooleanOptionsLabelConfig;
+    /**
+     * Callback chamado quando o campo perde o foco.
+     */
     onBlur?: (event: Event) => void;
+    /**
+     * Callback chamado quando o campo recebe foco.
+     */
     onFocus?: (event: Event) => void;
+    /**
+     * Callback chamado quando o usuário clica em uma opção.
+     */
     onClick?: (event: any) => void;
+    /**
+     * Quando `true`, exibe um botão de limpar a seleção.
+     * O texto do botão é definido em `optionsLabel.clear`.
+     */
     showClear?: boolean;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/boolean-switch-field.d.ts

@@ -1,8 +1,25 @@
 import { BooleanOptionsLabelConfig } from './boolean-field';
 import { FieldConfig } from './field';
+/**
+ * Configuração para campo booleano com exibição como toggle switch.
+ *
+ * Renderiza um interruptor visual de liga/desliga. Use quando o campo representa
+ * uma preferência ou configuração que pode ser ativada ou desativada de forma imediata.
+ *
+ * Diferente do `BooleanFieldConfig` (rádio sim/não), este campo usa o componente `s-switch`.
+ */
 export interface BooleanSwitchFieldConfig extends FieldConfig {
+    /** Tipo do campo: sempre `'booleanSwitch'`. */
     type: 'booleanSwitch';
+    /**
+     * Callback chamado quando o estado do switch muda (ligado ⇔ desligado).
+     */
     onChange?: (event: any) => void;
+    /**
+     * Labels opcionais exibidas ao lado do switch representando os estados.
+     * Se omitido, o switch é exibido sem labels de texto.
+     * @example { true: 'Ativo', false: 'Inativo' }
+     */
     optionsLabel?: BooleanOptionsLabelConfig;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/button-field.d.ts

@@ -1,11 +1,34 @@
 import { ButtonComponent } from '@seniorsistemas/angular-components/button';
 import { FieldConfig } from './field';
 type ExtractedButtonProperties = Partial<Pick<ButtonComponent, 'priority' | 'iconClass' | 'disabled' | 'auxiliary' | 'caret' | 'iconColor' | 'badge' | 'animation' | 'slide' | 'menuOptions' | 'baseZIndex' | 'styleClass' | 'rightIconClass' | 'tooltipPosition' | 'size' | 'type'>>;
+/**
+ * Configuração para campo do tipo botão dentro do DynamicForm.
+ *
+ * Renderiza um botão (`s-button`) diretamente como um campo do formulário.
+ * Útil para ações contextuais associadas ao formulário, como buscar dados, limpar campos
+ * ou acionar funcionalidades sem submeter o formulário.
+ *
+ * As propriedades visuais e comportamentais (priority, iconClass, menuOptions, etc.)
+ * são herdadas diretamente de `ButtonComponent`.
+ */
 export interface ButtonFieldConfig extends FieldConfig, ExtractedButtonProperties {
+    /** Tipo do campo: sempre `'button'`. */
     type: 'button';
+    /**
+     * Callback chamado quando o botão é clicado.
+     */
     onClick?: (event?: any) => any;
+    /**
+     * Quando `true`, o botão ocupa toda a largura da célula/coluna do formulário.
+     */
     fullWidth?: boolean;
+    /**
+     * Callback chamado quando o mouse entra na área do botão.
+     */
     mouseEnter?: (button: ButtonFieldConfig) => void;
+    /**
+     * Callback chamado quando o mouse sai da área do botão.
+     */
     mouseLeave?: (button: ButtonFieldConfig) => void;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/calendar-field.d.ts

@@ -1,25 +1,91 @@
 import { CalendarLocaleOptions } from '@seniorsistemas/angular-components/locale';
 import { FieldConfig } from './field';
+/**
+ * Configuração para campos de data e hora.
+ *
+ * Quatro variantes disponíveis:
+ * - `'date'` — apenas data (dia/mês/ano)
+ * - `'time'` — apenas hora (hora:minuto[:segundo])
+ * - `'dateTime'` — data com horário com timezone (UTC)
+ * - `'localDateTime'` — data com horário sem timezone (local da máquina)
+ *
+ * Suporta restrições de intervalo, modo de visualização (dia/mês/ano), seleção múltipla
+ * e localização de labels do calendário.
+ */
 export interface CalendarFieldConfig extends FieldConfig {
+    /**
+     * `'date'` — campo de data apenas.
+     * `'time'` — campo de hora apenas.
+     * `'dateTime'` — data e hora com timezone UTC.
+     * `'localDateTime'` — data e hora sem timezone (local).
+     */
     type: 'dateTime' | 'localDateTime' | 'time' | 'date';
+    /**
+     * Modo de visualização inicial do calendário.
+     * `'date'` — grade de dias (padrão).
+     * `'month'` — selector de mês.
+     * `'year'` — seletor de ano.
+     */
     view?: 'date' | 'month' | 'year';
+    /**
+     * Data mínima selecionável. Datas anteriores serão desabilitadas no calendário.
+     */
     minDate?: Date;
+    /**
+     * Data máxima selecionável. Datas posteriores serão desabilitadas no calendário.
+     */
     maxDate?: Date;
+    /**
+     * Data exibida inicialmente ao abrir o calendário quando nenhuma data está selecionada.
+     */
     defaultDate?: Date;
+    /**
+     * Elemento DOM ao qual o painel do calendário será anexado.
+     * Use `'body'` para evitar problemas de overflow em containers com `overflow: hidden`.
+     */
     appendTo?: string;
+    /**
+     * Quando `true`, o calendário abre automaticamente ao focar o campo.
+     * @default true
+     */
     showOnFocus?: boolean;
+    /**
+     * Opções de localização do calendário (nomes de dias da semana, meses, etc.).
+     * Se omitido, usa o locale padrão da aplicação.
+     */
     calendarLocaleOptions?: CalendarLocaleOptions;
+    /** Callback chamado quando o campo perde o foco. */
     onBlur?: (event: Event) => void;
+    /** Callback chamado quando o campo recebe foco. */
     onFocus?: (event: Event) => void;
+    /** Callback chamado quando o usuário seleciona uma data. */
     onSelect?: (event: any) => void;
+    /** Callback chamado quando o usuário digita manualmente no campo. */
     onInput?: (event: any) => void;
+    /** Callback chamado quando o painel do calendário é fechado. */
     onClose?: (event: any) => void;
+    /** Callback chamado quando o usuário clica no botão "Hoje". */
     onTodayClick?: (event: any) => void;
+    /** Callback chamado quando o usuário clica no botão "Limpar". */
     onClearClick?: (event: any) => void;
+    /** Callback chamado quando o mês visualizado muda. */
     onMonthChange?: (event: any) => void;
+    /** Callback chamado quando o ano visualizado muda. */
     onYearChange?: (event: any) => void;
+    /**
+     * Modo de seleção de datas.
+     * `'single'` — seleção de uma data (padrão).
+     * `'multiple'` — seleção de múltiplas datas incompatíveis.
+     */
     selectionMode?: 'single' | 'multiple';
+    /**
+     * Separador exibido entre as datas de início e fim quando `selectionMode = 'range'`.
+     * @default ' - '
+     */
     rangeSeparator?: string;
+    /**
+     * Quando `true`, exibe o seletor de segundos no modo de hora.
+     */
     showSeconds?: boolean;
 }
 declare module './field' {

package/dynamic-form/dynamic-form/form-field/configurations/fields/checkbox-field.d.ts

@@ -1,7 +1,22 @@
 import { CheckboxListData } from '@seniorsistemas/angular-components/checkbox-list';
 import { FieldConfig } from './field';
+/**
+ * Configuração para campo de múltipla escolha com checkboxes.
+ *
+ * Renderiza uma lista de checkboxes com suporte a agrupamento hierárquico via `CheckboxListData`.
+ * O valor do campo será um array com os valores dos itens selecionados.
+ *
+ * Use quando o usuário pode selecionar zero ou mais opções de uma lista finita.
+ * Para seleção única, prefira `type: 'radioButton'` ou `type: 'enum'`.
+ */
 export interface CheckboxFieldConfig extends FieldConfig {
+    /** Tipo do campo: sempre `'checkbox'`. */
     type: 'checkbox';
+    /**
+     * Dados que definem os itens e a estrutura hierárquica dos checkboxes.
+     * Importado de `@seniorsistemas/angular-components/checkbox-list`.
+     * Cada item possui `label`, `value` e opcionalmente `children` com sub-itens.
+     */
     data: CheckboxListData;
 }
 declare module './field' {