@seniorsistemas/angular-components 19.0.4 → 19.0.6

package/dialog/lib/src/dialog/dialog.component.d.ts

@@ -2,13 +2,64 @@ import { AfterViewInit, OnDestroy, TemplateRef } from '@angular/core';
 import { ActiveDialog } from './models/active-dialog';
 import { DialogSize } from './models/dialog-models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de diálogo modal que exibe conteúdo em uma janela sobreposta.
+ * Suporta templates customizados para cabeçalho, corpo e rodapé via `sTemplate`.
+ * Pode ser utilizado de forma declarativa (via `visible`) ou programática (via `DialogService`).
+ *
+ * @example
+ * ```html
+ * <!-- Modo declarativo -->
+ * <s-dialog header="Título" [(visible)]="showDialog">
+ *   <ng-template sTemplate="body">Conteúdo</ng-template>
+ *   <ng-template sTemplate="footer"><button (click)="showDialog = false">Fechar</button></ng-template>
+ * </s-dialog>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class DialogComponent implements AfterViewInit, OnDestroy {
+    /** @description Texto exibido no cabeçalho do diálogo. Pode ser substituído por um template com `sTemplate="header"`. */
     header: import("@angular/core").InputSignal<unknown>;
+    /**
+     * @description Controla a visibilidade do diálogo. Suporta two-way binding via `[(visible)]`.
+     * Ao definir `true`, o diálogo é aberto; ao definir `false`, é fechado.
+     * Não deve ser usado em conjunto com `DialogService` (modo programático).
+     */
     visible: import("@angular/core").ModelSignal<boolean | undefined>;
+    /**
+     * @description Instância do diálogo ativo.
+     * Em modo programático (aberto via `DialogService`): injetado do pai via `skipSelf`.
+     * Em modo declarativo (via `visible`): atribuído internamente ao abrir.
+     *
+     * O `providers` do componente sobrescreve o token com `null` para que descendentes
+     * (ex: `s-dialog` dentro de um lookup dentro deste diálogo) não herdem esta instância.
+     */
     activeDialog: ActiveDialog | null;
+    /**
+     * @description Tamanho do diálogo.
+     * Valores aceitos: `'sm'`, `'md'` (padrão), `'lg'`, `'xl'`, `'fullscreen'`.
+     *
+     * @default 'md'
+     */
     size: import("@angular/core").InputSignal<DialogSize>;
+    /**
+     * @description Classes CSS adicionais aplicadas ao container de conteúdo do diálogo.
+     *
+     * @default ''
+     */
     contentClassName: import("@angular/core").InputSignal<string>;
+    /**
+     * @description Quando `true`, pressionar a tecla Escape fecha o diálogo.
+     *
+     * @default true
+     */
     escapeOnEsc: import("@angular/core").InputSignal<boolean>;
+    /**
+     * @description Quando `true`, clicar fora do diálogo (no backdrop) fecha o diálogo.
+     *
+     * @default true
+     */
     destroyClickOutside: import("@angular/core").InputSignal<boolean>;
     private readonly viewContainerRef;
     private readonly dialogService;

package/dialog/lib/src/dialog/services/dialog.service.d.ts

@@ -1,6 +1,6 @@
-import { Overlay, OverlayRef } from "@angular/cdk/overlay";
+import { Overlay, OverlayRef } from '@angular/cdk/overlay';
 import { Injector, Type } from '@angular/core';
-import { ActiveDialog } from "../models/active-dialog";
+import { ActiveDialog } from '../models/active-dialog';
 import { DialogOptions, DialogRef } from '../models/dialog-models';
 import * as i0 from "@angular/core";
 export declare class DialogService {

package/dialog/lib/src/dialog/services/internal-dialog.service.d.ts

@@ -1,6 +1,6 @@
 import { TemplateRef, ViewContainerRef } from '@angular/core';
 import { DialogOptions } from '../models/dialog-models';
-import { DialogService } from "./dialog.service";
+import { DialogService } from './dialog.service';
 import * as i0 from "@angular/core";
 export declare class InternalDialogService extends DialogService {
     constructor();

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

@@ -5,7 +5,7 @@ import { MaskConfig } from '@seniorsistemas/ng2-currency-mask';
 import { HotkeysService } from 'angular2-hotkeys';
 import { SortMeta } from 'primeng/api';
 import { AutoComplete, AutoCompleteCompleteEvent } from 'primeng/autocomplete';
-import { Table } from 'primeng/table';
+import { Table, TableLazyLoadEvent } from 'primeng/table';
 import { DefaultFilter } from './types/default-filter';
 import { LabelOptions } from './types/label-options';
 import { LoadingStateIndicators } from '@seniorsistemas/angular-components/loading-state';
@@ -16,6 +16,7 @@ import { CurrencyFieldConfig } from '../../form-field/configurations/fields/curr
 import { TextFieldConfig } from '../../form-field/configurations/fields/text-field';
 import { DynamicType } from '../../form-field/configurations/fields/field';
 import { DynamicStructure } from '../../configurations/structure/structure';
+import { LookupSearchRequest } from './models/lookup-api.model';
 import * as i0 from "@angular/core";
 export declare class LookupComponent implements ControlValueAccessor, OnChanges, OnInit, OnDestroy {
     private readonly hotkeysService;
@@ -55,8 +56,8 @@ export declare class LookupComponent implements ControlValueAccessor, OnChanges,
     showEditOption: boolean;
     showRemoveOption: boolean;
     dialogFullScreen: import("@angular/core").InputSignal<boolean>;
-    onLookupRequest: EventEmitter<any>;
-    onSearchRequest: EventEmitter<any>;
+    onLookupRequest: EventEmitter<string>;
+    onSearchRequest: EventEmitter<LookupSearchRequest>;
     onFocus: EventEmitter<any>;
     onBlur: EventEmitter<any>;
     onKeyUp: EventEmitter<any>;
@@ -92,8 +93,8 @@ export declare class LookupComponent implements ControlValueAccessor, OnChanges,
     ngOnDestroy(): void;
     getGridData(): any[];
     getLookupSuggestions(): any[];
-    protected makeSearchRequestParams(event: any): any;
-    lazyLoadGrid(event: any): void;
+    protected makeSearchRequestParams(event: TableLazyLoadEvent): LookupSearchRequest;
+    lazyLoadGrid(event: TableLazyLoadEvent): void;
     onCompleteMethod(event: AutoCompleteCompleteEvent): void;
     setDefaultFilters(): void;
     showDialog(): Promise<void>;

package/dynamic-form/dynamic-form/components/lookup/models/lookup-api.model.d.ts

@@ -0,0 +1,5 @@
+export type LookupSearchRequest = {
+    filterData: Record<string, any>;
+    first: number;
+    rows: number;
+};

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

@@ -1,7 +1,21 @@
 import { StructureConfig } from './structure';
+/**
+ * Configuração para estrutura do tipo fieldset (grupo recolhível).
+ *
+ * Agrupa campos dentro de um painel que pode ser expandido ou recolhido pelo usuário.
+ * Útil para separar logicamente seções opcionais ou detalhes avançados do formulário.
+ */
 export interface FieldsetConfig extends StructureConfig {
+    /** Tipo da estrutura: sempre `'fieldset'`. */
     type: 'fieldset';
+    /**
+     * Callback chamado antes de o painel ser expandido ou recolhido.
+     * Pode ser usado para cancelar a ação ou realizar operações prévias.
+     */
     beforeToggle?: (event: any) => void;
+    /**
+     * Callback chamado após o painel ser expandido ou recolhido.
+     */
     afterToggle?: (event: any) => void;
 }
 declare module '../structure/structure' {

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' {