@seniorsistemas/angular-components-mcp 1.0.0-beta.3 → 1.0.0

package/dist/data/dynamic-form-metadata.json

@@ -0,0 +1,2281 @@
+{
+  "generatedAt": "2026-03-17T13:59:30.989Z",
+  "description": "Auto-generated from TypeScript source. Do not edit manually — run generate:dynamic-form-metadata.",
+  "baseTypes": {
+    "FieldConfig": {
+      "description": "Configuração base compartilhada por **todos** os tipos de campo do DynamicForm.\n\nToda interface específica de campo (ex: TextFieldConfig, SelectFieldConfig) estende esta interface.\nAs propriedades aqui definidas estão disponíveis em qualquer campo do formulário.",
+      "properties": {
+        "type": {
+          "type": "FieldType",
+          "required": true,
+          "description": "Tipo do campo. Deve ser um dos valores registrados em `FieldTypeMap`.\nExemplos: `'string'`, `'enum'`, `'date'`, `'lookup'`, `'boolean'`, etc.\nPara tipos opcionais (ex: `'editor'`), o provider correspondente deve ser registrado no `AppConfig` ou `AppModule`."
+        },
+        "required": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna se o campo é obrigatório dinamicamente.\nUse uma função para que a obrigatoriedade possa mudar em resposta ao estado do formulário."
+        },
+        "id": {
+          "type": "string",
+          "required": false,
+          "description": "ID HTML do elemento de input gerado. Útil para testes automatizados e acessibilidade."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "Nome do campo no modelo de dados. Deve corresponder à chave da propriedade no objeto de dados do formulário."
+        },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": "Rótulo exibido acima ou ao lado do campo no formulário.\nSe omitido, o campo é exibido sem label."
+        },
+        "infoSign": {
+          "type": "string",
+          "required": false,
+          "description": "Ícone de informação exibido ao lado do campo. Aceita classes de ícone (ex: `'ph ph-info'`)."
+        },
+        "tooltip": {
+          "type": "string",
+          "required": false,
+          "description": "Texto do tooltip exibido ao passar o mouse sobre o campo ou sobre o infoSign."
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false,
+          "description": "Texto de placeholder exibido enquanto o campo estiver vazio."
+        },
+        "displayTimeInfoSign": {
+          "type": "number",
+          "required": false,
+          "description": "Tempo em milissegundos para exibir automaticamente o infoSign quando o campo está focado.\nÚtil para orientar o usuário após um curto intervalo de inatividade."
+        },
+        "useInfoSignFocusedInputRef": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o infoSign usa a referência do input focado como âncora do tooltip.\nÚtil para garantir que o tooltip apareça próximo ao campo correto em layouts complexos."
+        }
+      }
+    },
+    "StructureConfig": {
+      "description": "Configuração base compartilhada por **todos** os tipos de estrutura do DynamicForm.\n\nEstruturas são contêineres que agrupam campos e outras estruturas.\nOs tipos disponíveis são: `'section'`, `'row'`, `'fieldset'`.",
+      "properties": {
+        "type": {
+          "type": "StructureType",
+          "required": true,
+          "description": "Tipo da estrutura. Deve ser um dos valores registrados em `StructureTypeMap`.\nValores disponíveis: `'section'`, `'row'`, `'fieldset'`."
+        },
+        "configs": {
+          "type": "(DynamicType | DynamicStructure)[]",
+          "required": true,
+          "description": "Lista de campos e sub-estruturas contidas nesta estrutura.\nCada item pode ser um `DynamicType` (campo) ou `DynamicStructure` (estrutura aninhada)."
+        },
+        "header": {
+          "type": "string",
+          "required": false,
+          "description": "Título opcional exibido no cabeçalho da estrutura.\nUsado, por exemplo, como título de seções ou fieldsets."
+        }
+      }
+    }
+  },
+  "fieldTypes": {
+    "autocomplete": {
+      "interface": "AutocompleteFieldConfig",
+      "sourceFile": "autocomplete-field.ts",
+      "description": "Configuração para campo de autocompletar.\n\nExibe um input de texto que sugere opções enquanto o usuário digita, buscando os dados\nvia Observable. Suporta seleção simples ou múltipla e personalização do campo exibido.",
+      "ownProperties": {
+        "type": {
+          "type": "'autocomplete'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'autocomplete'`."
+        },
+        "dataKey": {
+          "type": "string",
+          "required": false,
+          "description": "Chave única de cada item da lista de sugestões. Usada para identificar o objeto selecionado."
+        },
+        "displayField": {
+          "type": "string",
+          "required": false,
+          "description": "Nome da propriedade do objeto de sugestão que será exibida como texto na lista e no input."
+        },
+        "multiple": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, permite seleção de múltiplos itens exibidos como tags/chips."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel de sugestões será anexado.\nUse `'body'` para evitar problemas de overflow em containers com `overflow: hidden`."
+        },
+        "emptyMessage": {
+          "type": "string",
+          "required": false,
+          "description": "Mensagem exibida quando nenhuma sugestão é encontrada para o texto digitado."
+        },
+        "suggestionsObservable": {
+          "type": "Observable<any>",
+          "required": false,
+          "description": "Observable que emite a lista de sugestões em resposta à digitação do usuário.\nDeve emitir um array de objetos com pelo menos a propriedade `displayField`."
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona um item da lista de sugestões."
+        },
+        "onUnselect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário remove um item selecionado (modo múltiplo)."
+        },
+        "onClear": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário limpa o campo."
+        },
+        "onSearch": {
+          "type": "(value: string) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no texto digitado. Use para disparar a busca de sugestões."
+        },
+        "onBlur": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        }
+      }
+    },
+    "number": {
+      "interface": "BignumberFieldConfig",
+      "sourceFile": "bignumber-field.ts",
+      "description": "Configuração para campos numéricos de grande precisão.\n\nUse `type: 'number'` para números inteiros ou decimais genéricos.\nUse `type: 'double'` para números com casas decimais explícitas.\n\nSuporta controle de precisão, escala, máscaras, addons laterais e formatação regional.\nPreferível em relação ao `NumberFieldConfig` (deprecated).",
+      "ownProperties": {
+        "type": {
+          "type": "'number' | 'double'",
+          "required": true,
+          "description": "`'number'` — campo numérico genérico (inteiro ou decimal).\n`'double'` — campo numérico com casas decimais."
+        },
+        "allowNegative": {
+          "type": "boolean",
+          "required": false,
+          "description": "Permite a entrada de valores negativos."
+        },
+        "numberLocaleOptions": {
+          "type": "NumberLocaleOptions",
+          "required": false,
+          "description": "Opções de localização para formatação do número (separador decimal, separador de milhar).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser."
+        },
+        "precision": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número total de dígitos (inteiros + decimais). Pode ser uma função para controle dinâmico."
+        },
+        "scale": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número de casas decimais permitidas. Pode ser uma função para controle dinâmico."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada. Pode ser uma string fixa ou função que retorna a máscara."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do campo (ex: símbolo de moeda, unidade de medida)."
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do campo (ex: unidade de medida, botão)."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        },
+        "autoClear": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, limpa o valor do campo automaticamente ao perder o foco se o valor for inválido."
+        },
+        "alignTo": {
+          "type": "'left' | 'right'",
+          "required": false,
+          "description": "Alinhamento do texto dentro do campo.\n`'left'` — alinhado à esquerda (padrão).\n`'right'` — alinhado à direita (comum em campos monetários)."
+        }
+      }
+    },
+    "double": {
+      "interface": "BignumberFieldConfig",
+      "sourceFile": "bignumber-field.ts",
+      "description": "Configuração para campos numéricos de grande precisão.\n\nUse `type: 'number'` para números inteiros ou decimais genéricos.\nUse `type: 'double'` para números com casas decimais explícitas.\n\nSuporta controle de precisão, escala, máscaras, addons laterais e formatação regional.\nPreferível em relação ao `NumberFieldConfig` (deprecated).",
+      "ownProperties": {
+        "type": {
+          "type": "'number' | 'double'",
+          "required": true,
+          "description": "`'number'` — campo numérico genérico (inteiro ou decimal).\n`'double'` — campo numérico com casas decimais."
+        },
+        "allowNegative": {
+          "type": "boolean",
+          "required": false,
+          "description": "Permite a entrada de valores negativos."
+        },
+        "numberLocaleOptions": {
+          "type": "NumberLocaleOptions",
+          "required": false,
+          "description": "Opções de localização para formatação do número (separador decimal, separador de milhar).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser."
+        },
+        "precision": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número total de dígitos (inteiros + decimais). Pode ser uma função para controle dinâmico."
+        },
+        "scale": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número de casas decimais permitidas. Pode ser uma função para controle dinâmico."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada. Pode ser uma string fixa ou função que retorna a máscara."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do campo (ex: símbolo de moeda, unidade de medida)."
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do campo (ex: unidade de medida, botão)."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        },
+        "autoClear": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, limpa o valor do campo automaticamente ao perder o foco se o valor for inválido."
+        },
+        "alignTo": {
+          "type": "'left' | 'right'",
+          "required": false,
+          "description": "Alinhamento do texto dentro do campo.\n`'left'` — alinhado à esquerda (padrão).\n`'right'` — alinhado à direita (comum em campos monetários)."
+        }
+      }
+    },
+    "blob": {
+      "interface": "BlobFieldConfig",
+      "sourceFile": "blob-field.ts",
+      "description": "Configuração para campo de upload de arquivos binários.\n\nExibe uma área de upload com suporte a múltiplos arquivos, progresso de envio,\nvisualização de arquivos enviados e download.\n\nTodas as propriedades são obrigatórias, pois o componente depende de labels e handlers\npara opções de ação e controle dos arquivos.",
+      "ownProperties": {
+        "type": {
+          "type": "'blob'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'blob'`."
+        },
+        "accept": {
+          "type": "string",
+          "required": true,
+          "description": "Tipos de arquivo aceitos no seletor de arquivo nativo (MIME types ou extensões)."
+        },
+        "files": {
+          "type": "FileDto[]",
+          "required": true,
+          "description": "Lista dos arquivos atualmente associados ao campo.\nDeve ser inicializada como array vazio `[]` ao criar o formulário."
+        },
+        "chooseLabel": {
+          "type": "string",
+          "required": true,
+          "description": "Rótulo do botão de escolher/adicionar arquivo."
+        },
+        "removeLabel": {
+          "type": "string",
+          "required": true,
+          "description": "Rótulo do botão de remover um arquivo da lista."
+        },
+        "cancelLabel": {
+          "type": "string",
+          "required": true,
+          "description": "Rótulo do botão de cancelar o upload em andamento."
+        },
+        "successTooltip": {
+          "type": "string",
+          "required": true,
+          "description": "Texto do tooltip exibido quando o upload é concluído com sucesso."
+        },
+        "multiple": {
+          "type": "boolean",
+          "required": true,
+          "description": "Permite selecionar e enviar múltiplos arquivos simultaneamente."
+        },
+        "onUploadFile": {
+          "type": "(event: {\n    files: FileDto[];\n}, field: BlobFieldConfig) => void",
+          "required": true,
+          "description": "Callback chamado após o envio bem-sucedido de arquivos.\nRecebe a lista de arquivos enviados e a instância da configuração do campo."
+        },
+        "onRemoveFile": {
+          "type": "(event: FileDto, field: BlobFieldConfig) => void",
+          "required": true,
+          "description": "Callback chamado quando o usuário remove um arquivo da lista."
+        },
+        "onCancelUpload": {
+          "type": "(event: number, field: BlobFieldConfig) => void",
+          "required": true,
+          "description": "Callback chamado quando o usuário cancela um upload em andamento.\nO `event` é o índice do arquivo na fila de upload."
+        },
+        "onDownloadFile": {
+          "type": "(event: {\n    index: number;\n    anchor: ElementRef;\n}, field: BlobFieldConfig) => void",
+          "required": true,
+          "description": "Callback chamado quando o usuário clica para baixar um arquivo já enviado.\nRecebe o índice do arquivo e a referência ao elemento anchor de download."
+        },
+        "showFileUploadDate": {
+          "type": "boolean",
+          "required": true,
+          "description": "Quando `true`, exibe a data de upload de cada arquivo na lista."
+        }
+      }
+    },
+    "boolean": {
+      "interface": "BooleanFieldConfig",
+      "sourceFile": "boolean-field.ts",
+      "description": "Configuração para campo booleano com exibição como botões de rádio (Sim/Não).\n\nExibe dois (ou três, com `showClear`) botões de rádio rotulados conforme `optionsLabel`.\nDiferente do `booleanSwitch`, este campo é mais adequado para questionários e formulários\nque precisam de rotação explícita entre as opções sim/não.",
+      "ownProperties": {
+        "type": {
+          "type": "'boolean'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'boolean'`."
+        },
+        "verticalAlignment": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, os botões são empilhados verticalmente em vez de na horizontal."
+        },
+        "optionsLabel": {
+          "type": "BooleanOptionsLabelConfig",
+          "required": true,
+          "description": "Labels exibidas para as opções do campo. Obrigatório."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica em uma opção."
+        },
+        "showClear": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe um botão de limpar a seleção.\nO texto do botão é definido em `optionsLabel.clear`."
+        }
+      }
+    },
+    "booleanSwitch": {
+      "interface": "BooleanSwitchFieldConfig",
+      "sourceFile": "boolean-switch-field.ts",
+      "description": "Configuração para campo booleano com exibição como toggle switch.\n\nRenderiza um interruptor visual de liga/desliga. Use quando o campo representa\numa preferência ou configuração que pode ser ativada ou desativada de forma imediata.\n\nDiferente do `BooleanFieldConfig` (rádio sim/não), este campo usa o componente `s-switch`.",
+      "ownProperties": {
+        "type": {
+          "type": "'booleanSwitch'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'booleanSwitch'`."
+        },
+        "onChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o estado do switch muda (ligado ⇔ desligado)."
+        },
+        "optionsLabel": {
+          "type": "BooleanOptionsLabelConfig",
+          "required": false,
+          "description": "Labels opcionais exibidas ao lado do switch representando os estados.\nSe omitido, o switch é exibido sem labels de texto."
+        }
+      }
+    },
+    "button": {
+      "interface": "ButtonFieldConfig",
+      "sourceFile": "button-field.ts",
+      "description": "Configuração para campo do tipo botão dentro do DynamicForm.\n\nRenderiza um botão (`s-button`) diretamente como um campo do formulário.\nÚtil para ações contextuais associadas ao formulário, como buscar dados, limpar campos\nou acionar funcionalidades sem submeter o formulário.\n\nAs propriedades visuais e comportamentais (priority, iconClass, menuOptions, etc.)\nsão herdadas diretamente de `ButtonComponent`.",
+      "ownProperties": {
+        "type": {
+          "type": "'button'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'button'`."
+        },
+        "onClick": {
+          "type": "(event?: any) => any",
+          "required": false,
+          "description": "Callback chamado quando o botão é clicado."
+        },
+        "fullWidth": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o botão ocupa toda a largura da célula/coluna do formulário."
+        },
+        "mouseEnter": {
+          "type": "(button: ButtonFieldConfig) => void",
+          "required": false,
+          "description": "Callback chamado quando o mouse entra na área do botão."
+        },
+        "mouseLeave": {
+          "type": "(button: ButtonFieldConfig) => void",
+          "required": false,
+          "description": "Callback chamado quando o mouse sai da área do botão."
+        }
+      }
+    },
+    "dateTime": {
+      "interface": "CalendarFieldConfig",
+      "sourceFile": "calendar-field.ts",
+      "description": "Configuração para campos de data e hora.\n\nQuatro variantes disponíveis:\n- `'date'` — apenas data (dia/mês/ano)\n- `'time'` — apenas hora (hora:minuto[:segundo])\n- `'dateTime'` — data com horário com timezone (UTC)\n- `'localDateTime'` — data com horário sem timezone (local da máquina)\n\nSuporta restrições de intervalo, modo de visualização (dia/mês/ano), seleção múltipla\ne localização de labels do calendário.",
+      "ownProperties": {
+        "type": {
+          "type": "'dateTime' | 'localDateTime' | 'time' | 'date'",
+          "required": true,
+          "description": "`'date'` — campo de data apenas.\n`'time'` — campo de hora apenas.\n`'dateTime'` — data e hora com timezone UTC.\n`'localDateTime'` — data e hora sem timezone (local)."
+        },
+        "view": {
+          "type": "'date' | 'month' | 'year'",
+          "required": false,
+          "description": "Modo de visualização inicial do calendário.\n`'date'` — grade de dias (padrão).\n`'month'` — selector de mês.\n`'year'` — seletor de ano."
+        },
+        "minDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data mínima selecionável. Datas anteriores serão desabilitadas no calendário."
+        },
+        "maxDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data máxima selecionável. Datas posteriores serão desabilitadas no calendário."
+        },
+        "defaultDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data exibida inicialmente ao abrir o calendário quando nenhuma data está selecionada."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel do calendário será anexado.\nUse `'body'` para evitar problemas de overflow em containers com `overflow: hidden`."
+        },
+        "showOnFocus": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o calendário abre automaticamente ao focar o campo."
+        },
+        "calendarLocaleOptions": {
+          "type": "CalendarLocaleOptions",
+          "required": false,
+          "description": "Opções de localização do calendário (nomes de dias da semana, meses, etc.).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona uma data."
+        },
+        "onInput": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário digita manualmente no campo."
+        },
+        "onClose": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o painel do calendário é fechado."
+        },
+        "onTodayClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Hoje\"."
+        },
+        "onClearClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Limpar\"."
+        },
+        "onMonthChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o mês visualizado muda."
+        },
+        "onYearChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o ano visualizado muda."
+        },
+        "selectionMode": {
+          "type": "'single' | 'multiple'",
+          "required": false,
+          "description": "Modo de seleção de datas.\n`'single'` — seleção de uma data (padrão).\n`'multiple'` — seleção de múltiplas datas incompatíveis."
+        },
+        "rangeSeparator": {
+          "type": "string",
+          "required": false,
+          "description": "Separador exibido entre as datas de início e fim quando `selectionMode = 'range'`."
+        },
+        "showSeconds": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o seletor de segundos no modo de hora."
+        }
+      }
+    },
+    "localDateTime": {
+      "interface": "CalendarFieldConfig",
+      "sourceFile": "calendar-field.ts",
+      "description": "Configuração para campos de data e hora.\n\nQuatro variantes disponíveis:\n- `'date'` — apenas data (dia/mês/ano)\n- `'time'` — apenas hora (hora:minuto[:segundo])\n- `'dateTime'` — data com horário com timezone (UTC)\n- `'localDateTime'` — data com horário sem timezone (local da máquina)\n\nSuporta restrições de intervalo, modo de visualização (dia/mês/ano), seleção múltipla\ne localização de labels do calendário.",
+      "ownProperties": {
+        "type": {
+          "type": "'dateTime' | 'localDateTime' | 'time' | 'date'",
+          "required": true,
+          "description": "`'date'` — campo de data apenas.\n`'time'` — campo de hora apenas.\n`'dateTime'` — data e hora com timezone UTC.\n`'localDateTime'` — data e hora sem timezone (local)."
+        },
+        "view": {
+          "type": "'date' | 'month' | 'year'",
+          "required": false,
+          "description": "Modo de visualização inicial do calendário.\n`'date'` — grade de dias (padrão).\n`'month'` — selector de mês.\n`'year'` — seletor de ano."
+        },
+        "minDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data mínima selecionável. Datas anteriores serão desabilitadas no calendário."
+        },
+        "maxDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data máxima selecionável. Datas posteriores serão desabilitadas no calendário."
+        },
+        "defaultDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data exibida inicialmente ao abrir o calendário quando nenhuma data está selecionada."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel do calendário será anexado.\nUse `'body'` para evitar problemas de overflow em containers com `overflow: hidden`."
+        },
+        "showOnFocus": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o calendário abre automaticamente ao focar o campo."
+        },
+        "calendarLocaleOptions": {
+          "type": "CalendarLocaleOptions",
+          "required": false,
+          "description": "Opções de localização do calendário (nomes de dias da semana, meses, etc.).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona uma data."
+        },
+        "onInput": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário digita manualmente no campo."
+        },
+        "onClose": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o painel do calendário é fechado."
+        },
+        "onTodayClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Hoje\"."
+        },
+        "onClearClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Limpar\"."
+        },
+        "onMonthChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o mês visualizado muda."
+        },
+        "onYearChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o ano visualizado muda."
+        },
+        "selectionMode": {
+          "type": "'single' | 'multiple'",
+          "required": false,
+          "description": "Modo de seleção de datas.\n`'single'` — seleção de uma data (padrão).\n`'multiple'` — seleção de múltiplas datas incompatíveis."
+        },
+        "rangeSeparator": {
+          "type": "string",
+          "required": false,
+          "description": "Separador exibido entre as datas de início e fim quando `selectionMode = 'range'`."
+        },
+        "showSeconds": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o seletor de segundos no modo de hora."
+        }
+      }
+    },
+    "time": {
+      "interface": "CalendarFieldConfig",
+      "sourceFile": "calendar-field.ts",
+      "description": "Configuração para campos de data e hora.\n\nQuatro variantes disponíveis:\n- `'date'` — apenas data (dia/mês/ano)\n- `'time'` — apenas hora (hora:minuto[:segundo])\n- `'dateTime'` — data com horário com timezone (UTC)\n- `'localDateTime'` — data com horário sem timezone (local da máquina)\n\nSuporta restrições de intervalo, modo de visualização (dia/mês/ano), seleção múltipla\ne localização de labels do calendário.",
+      "ownProperties": {
+        "type": {
+          "type": "'dateTime' | 'localDateTime' | 'time' | 'date'",
+          "required": true,
+          "description": "`'date'` — campo de data apenas.\n`'time'` — campo de hora apenas.\n`'dateTime'` — data e hora com timezone UTC.\n`'localDateTime'` — data e hora sem timezone (local)."
+        },
+        "view": {
+          "type": "'date' | 'month' | 'year'",
+          "required": false,
+          "description": "Modo de visualização inicial do calendário.\n`'date'` — grade de dias (padrão).\n`'month'` — selector de mês.\n`'year'` — seletor de ano."
+        },
+        "minDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data mínima selecionável. Datas anteriores serão desabilitadas no calendário."
+        },
+        "maxDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data máxima selecionável. Datas posteriores serão desabilitadas no calendário."
+        },
+        "defaultDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data exibida inicialmente ao abrir o calendário quando nenhuma data está selecionada."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel do calendário será anexado.\nUse `'body'` para evitar problemas de overflow em containers com `overflow: hidden`."
+        },
+        "showOnFocus": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o calendário abre automaticamente ao focar o campo."
+        },
+        "calendarLocaleOptions": {
+          "type": "CalendarLocaleOptions",
+          "required": false,
+          "description": "Opções de localização do calendário (nomes de dias da semana, meses, etc.).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona uma data."
+        },
+        "onInput": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário digita manualmente no campo."
+        },
+        "onClose": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o painel do calendário é fechado."
+        },
+        "onTodayClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Hoje\"."
+        },
+        "onClearClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Limpar\"."
+        },
+        "onMonthChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o mês visualizado muda."
+        },
+        "onYearChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o ano visualizado muda."
+        },
+        "selectionMode": {
+          "type": "'single' | 'multiple'",
+          "required": false,
+          "description": "Modo de seleção de datas.\n`'single'` — seleção de uma data (padrão).\n`'multiple'` — seleção de múltiplas datas incompatíveis."
+        },
+        "rangeSeparator": {
+          "type": "string",
+          "required": false,
+          "description": "Separador exibido entre as datas de início e fim quando `selectionMode = 'range'`."
+        },
+        "showSeconds": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o seletor de segundos no modo de hora."
+        }
+      }
+    },
+    "date": {
+      "interface": "CalendarFieldConfig",
+      "sourceFile": "calendar-field.ts",
+      "description": "Configuração para campos de data e hora.\n\nQuatro variantes disponíveis:\n- `'date'` — apenas data (dia/mês/ano)\n- `'time'` — apenas hora (hora:minuto[:segundo])\n- `'dateTime'` — data com horário com timezone (UTC)\n- `'localDateTime'` — data com horário sem timezone (local da máquina)\n\nSuporta restrições de intervalo, modo de visualização (dia/mês/ano), seleção múltipla\ne localização de labels do calendário.",
+      "ownProperties": {
+        "type": {
+          "type": "'dateTime' | 'localDateTime' | 'time' | 'date'",
+          "required": true,
+          "description": "`'date'` — campo de data apenas.\n`'time'` — campo de hora apenas.\n`'dateTime'` — data e hora com timezone UTC.\n`'localDateTime'` — data e hora sem timezone (local)."
+        },
+        "view": {
+          "type": "'date' | 'month' | 'year'",
+          "required": false,
+          "description": "Modo de visualização inicial do calendário.\n`'date'` — grade de dias (padrão).\n`'month'` — selector de mês.\n`'year'` — seletor de ano."
+        },
+        "minDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data mínima selecionável. Datas anteriores serão desabilitadas no calendário."
+        },
+        "maxDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data máxima selecionável. Datas posteriores serão desabilitadas no calendário."
+        },
+        "defaultDate": {
+          "type": "Date",
+          "required": false,
+          "description": "Data exibida inicialmente ao abrir o calendário quando nenhuma data está selecionada."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel do calendário será anexado.\nUse `'body'` para evitar problemas de overflow em containers com `overflow: hidden`."
+        },
+        "showOnFocus": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o calendário abre automaticamente ao focar o campo."
+        },
+        "calendarLocaleOptions": {
+          "type": "CalendarLocaleOptions",
+          "required": false,
+          "description": "Opções de localização do calendário (nomes de dias da semana, meses, etc.).\nSe omitido, usa o locale padrão da aplicação."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona uma data."
+        },
+        "onInput": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário digita manualmente no campo."
+        },
+        "onClose": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o painel do calendário é fechado."
+        },
+        "onTodayClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Hoje\"."
+        },
+        "onClearClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão \"Limpar\"."
+        },
+        "onMonthChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o mês visualizado muda."
+        },
+        "onYearChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o ano visualizado muda."
+        },
+        "selectionMode": {
+          "type": "'single' | 'multiple'",
+          "required": false,
+          "description": "Modo de seleção de datas.\n`'single'` — seleção de uma data (padrão).\n`'multiple'` — seleção de múltiplas datas incompatíveis."
+        },
+        "rangeSeparator": {
+          "type": "string",
+          "required": false,
+          "description": "Separador exibido entre as datas de início e fim quando `selectionMode = 'range'`."
+        },
+        "showSeconds": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o seletor de segundos no modo de hora."
+        }
+      }
+    },
+    "checkbox": {
+      "interface": "CheckboxFieldConfig",
+      "sourceFile": "checkbox-field.ts",
+      "description": "Configuração para campo de múltipla escolha com checkboxes.\n\nRenderiza uma lista de checkboxes com suporte a agrupamento hierárquico via `CheckboxListData`.\nO valor do campo será um array com os valores dos itens selecionados.\n\nUse quando o usuário pode selecionar zero ou mais opções de uma lista finita.\nPara seleção única, prefira `type: 'radioButton'` ou `type: 'enum'`.",
+      "ownProperties": {
+        "type": {
+          "type": "'checkbox'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'checkbox'`."
+        },
+        "data": {
+          "type": "CheckboxListData",
+          "required": true,
+          "description": "Dados que definem os itens e a estrutura hierárquica dos checkboxes.\nImportado de `@seniorsistemas/angular-components/checkbox-list`.\nCada item possui `label`, `value` e opcionalmente `children` com sub-itens."
+        }
+      }
+    },
+    "chips": {
+      "interface": "ChipsFieldConfig",
+      "sourceFile": "chips-field.ts",
+      "description": "Configuração para campo de entrada de múltiplas tags (chips).\n\nPermite que o usuário insira vários valores de texto livres, visualizados como chips/tags.\nCada valor é adicionado ao pressionar Enter (ou o separador configurado).\nO valor do campo é um array de strings.\n\nUse para e-mails, palavras-chave, códigos ou qualquer lista de valores livres.",
+      "ownProperties": {
+        "type": {
+          "type": "'chips'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'chips'`."
+        },
+        "keyFilter": {
+          "type": "RegExp",
+          "required": false,
+          "description": "Expressão regular que filtra os caracteres aceitos em cada chip."
+        },
+        "separator": {
+          "type": "string",
+          "required": false,
+          "description": "Caractere separador para adicionar novos chips além do Enter."
+        },
+        "showCopyButton": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe um botão de copiar todos os chips para a área de transferência."
+        },
+        "onAdd": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando um novo chip é adicionado."
+        },
+        "onRemove": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando um chip é removido."
+        },
+        "onChipClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica em um chip existente."
+        },
+        "onFocus": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onBlur": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onCopy": {
+          "type": "(content: string) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário copia o conteúdo dos chips.\nRecebe o texto combinado de todos os chips."
+        }
+      }
+    },
+    "contentGenerator": {
+      "interface": "ContentGeneratorFieldConfig",
+      "sourceFile": "content-generator-field.ts",
+      "description": "Configuração para campo de área de texto com geração de conteúdo via IA.\n\nCombina um textarea completo com recursos de:\n- Geração automática de texto por IA via prompt\n- Reconhecimento de voz (speech-to-text)\n- Contexto persistente entre gerações (`keepContext`)\n\nUse `type: 'contentGenerator'` para novas implementações.\nO tipo `'textAreaIA'` está depreciado e será removido na v20.",
+      "ownProperties": {
+        "type": {
+          "type": "'contentGenerator' | 'textAreaIA'",
+          "required": true,
+          "description": "`'contentGenerator'` — tipo atual recomendado.\n`'textAreaIA'` — **@deprecated** Será removido na v20, use `'contentGenerator'`."
+        },
+        "cols": {
+          "type": "number",
+          "required": false,
+          "description": "Número de colunas de texto do textarea."
+        },
+        "rows": {
+          "type": "number",
+          "required": false,
+          "description": "Número de linhas visíveis do textarea."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas. Aceita regex ou string."
+        },
+        "style": {
+          "type": "Partial<CSSStyleDeclaration>",
+          "required": false,
+          "description": "Estilos CSS inline aplicados diretamente no elemento textarea."
+        },
+        "prompt": {
+          "type": "string",
+          "required": false,
+          "description": "Prompt inicial enviado à IA para gerar conteúdo.\nDefine a instrução base para o assistente de geração de texto."
+        },
+        "readonly": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna `true` quando o campo deve estar em modo somente-leitura."
+        },
+        "speechRecognition": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, ativa o botão de reconhecimento de voz (speech-to-text).\nO conteúdo falado é convertido em texto e inserido no campo."
+        },
+        "keepContext": {
+          "type": "boolean",
+          "required": true,
+          "description": "Quando `true`, o contexto das gerações anteriores é mantido ao gerar novo conteúdo.\nPermite que a IA considere o histórico da conversa na próxima geração."
+        },
+        "speechRecognitionPlaceholder": {
+          "type": "string",
+          "required": true,
+          "description": "Texto de placeholder exibido na área de reconhecimento de voz enquanto o microfone está ativo."
+        },
+        "maxLength": {
+          "type": "number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos no campo."
+        }
+      }
+    },
+    "textAreaIA": {
+      "interface": "ContentGeneratorFieldConfig",
+      "sourceFile": "content-generator-field.ts",
+      "description": "Configuração para campo de área de texto com geração de conteúdo via IA.\n\nCombina um textarea completo com recursos de:\n- Geração automática de texto por IA via prompt\n- Reconhecimento de voz (speech-to-text)\n- Contexto persistente entre gerações (`keepContext`)\n\nUse `type: 'contentGenerator'` para novas implementações.\nO tipo `'textAreaIA'` está depreciado e será removido na v20.",
+      "ownProperties": {
+        "type": {
+          "type": "'contentGenerator' | 'textAreaIA'",
+          "required": true,
+          "description": "`'contentGenerator'` — tipo atual recomendado.\n`'textAreaIA'` — **@deprecated** Será removido na v20, use `'contentGenerator'`."
+        },
+        "cols": {
+          "type": "number",
+          "required": false,
+          "description": "Número de colunas de texto do textarea."
+        },
+        "rows": {
+          "type": "number",
+          "required": false,
+          "description": "Número de linhas visíveis do textarea."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas. Aceita regex ou string."
+        },
+        "style": {
+          "type": "Partial<CSSStyleDeclaration>",
+          "required": false,
+          "description": "Estilos CSS inline aplicados diretamente no elemento textarea."
+        },
+        "prompt": {
+          "type": "string",
+          "required": false,
+          "description": "Prompt inicial enviado à IA para gerar conteúdo.\nDefine a instrução base para o assistente de geração de texto."
+        },
+        "readonly": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna `true` quando o campo deve estar em modo somente-leitura."
+        },
+        "speechRecognition": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, ativa o botão de reconhecimento de voz (speech-to-text).\nO conteúdo falado é convertido em texto e inserido no campo."
+        },
+        "keepContext": {
+          "type": "boolean",
+          "required": true,
+          "description": "Quando `true`, o contexto das gerações anteriores é mantido ao gerar novo conteúdo.\nPermite que a IA considere o histórico da conversa na próxima geração."
+        },
+        "speechRecognitionPlaceholder": {
+          "type": "string",
+          "required": true,
+          "description": "Texto de placeholder exibido na área de reconhecimento de voz enquanto o microfone está ativo."
+        },
+        "maxLength": {
+          "type": "number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos no campo."
+        }
+      }
+    },
+    "countryPhonePicker": {
+      "interface": "CountryPhonePickerConfig",
+      "sourceFile": "country-phone-picker-field.ts",
+      "description": "Configuração para campo de seleção de país com entrada de número de telefone.\n\nCombina um dropdown de seleção de país (com bandeira e código DDI) com um campo de telefone\nque aplica automaticamente a máscara de cada país selecionado.\n\nO valor do campo é do tipo `PhoneSelectionData`, contendo o país e o número.",
+      "ownProperties": {
+        "type": {
+          "type": "'countryPhonePicker'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'countryPhonePicker'`."
+        },
+        "countries": {
+          "type": "string[]",
+          "required": true,
+          "description": "Lista de códigos de países disponíveis no dropdown.\nUse códigos ISO 3166-1 alpha-2 em maiúsculas."
+        },
+        "ordination": {
+          "type": "Ordination",
+          "required": true,
+          "description": "Critério de ordenação dos países no dropdown.\nImportado de `@seniorsistemas/angular-components/country-phone-picker`."
+        },
+        "onSelected": {
+          "type": "(data: CountryPhoneData) => void",
+          "required": true,
+          "description": "Callback obrigatório chamado quando o país é selecionado.\nRecebe os dados do país escolhido (nome, DDI, código)."
+        },
+        "onFocusLost": {
+          "type": "(data: PhoneSelectionData | null) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo de telefone perde o foco.\nRecebe os dados completos da seleção (país + número), ou `null` se vazio."
+        }
+      }
+    },
+    "money": {
+      "interface": "CurrencyFieldConfig",
+      "sourceFile": "currency-field.ts",
+      "description": "Configuração para campo monetário com símbolo de moeda.",
+      "ownProperties": {
+        "type": {
+          "type": "'money'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'money'`."
+        },
+        "alignTo": {
+          "type": "'left' | 'right'",
+          "required": false,
+          "description": "Alinhamento do texto dentro do campo.\n`'left'` — alinhado à esquerda.\n`'right'` — alinhado à direita (comum em campos monetários)."
+        },
+        "currency": {
+          "type": "() => Currency",
+          "required": false,
+          "description": "Função que retorna o objeto de moeda a ser exibido junto ao valor.\nInclui símbolo, código e formatação."
+        }
+      }
+    },
+    "lookup": {
+      "interface": "LookupFieldConfig",
+      "sourceFile": "lookup-field.ts",
+      "description": "Configuração para campo de pesquisa avançada (Lookup).\n\nExibe um input com autocompletar e botão de pesquisa que abre um diálogo com grid de resultados.\nSuporta seleção simples ou múltipla, filtros padrão, ações CRUD na seleção e configuração\ndinâmica das colunas da grade.\n\nRequer dois Observables:\n- `suggestionsObservable`: para sugestões no autocompletar\n- `searchObservable`: para a grade de resultados do diálogo",
+      "ownProperties": {
+        "type": {
+          "type": "'lookup'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'lookup'`."
+        },
+        "defaultValue": {
+          "type": "any",
+          "required": false,
+          "description": "Valor padrão pré-selecionado ao inicializar o formulário."
+        },
+        "multiple": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, permite selecionar múltiplos registros exibidos como tags."
+        },
+        "showSearch": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o botão de pesquisa avançada que abre o diálogo com a grade."
+        },
+        "searchFields": {
+          "type": "DynamicType[]",
+          "required": true,
+          "description": "Colunas de filtro exibidas no diálogo de pesquisa avançada.\nCada item define o campo de filtro disponível para o usuário."
+        },
+        "searchGridFields": {
+          "type": "DynamicType[]",
+          "required": true,
+          "description": "Colunas exibidas na grade de resultados do diálogo de pesquisa.\nCada item define uma coluna com header e campo de dados."
+        },
+        "suggestionsObservable": {
+          "type": "Observable<any[]>",
+          "required": true,
+          "description": "Observable que emite sugestões para o autocompletar do input do lookup.\nDeve emitir um array de objetos com a propriedade `lookupDisplayField`."
+        },
+        "searchObservable": {
+          "type": "Observable<SearchObservable>",
+          "required": true,
+          "description": "Observable que emite os dados da grade do diálogo de pesquisa avançada.\nDeve emitir um objeto `SearchObservable` com `gridData` e `totalRecords`.\n\nEstrutura de `SearchObservable`: `{ gridData: any[]; totalRecords: number; searchTotalRecordsLabel?: string; }`",
+          "imports": [
+            "import { SearchObservable } from '@seniorsistemas/angular-components/dynamic-form';"
+          ]
+        },
+        "dataKey": {
+          "type": "string",
+          "required": true,
+          "description": "Nome da propriedade única do objeto que identifica cada registro."
+        },
+        "lookupDisplayField": {
+          "type": "string",
+          "required": true,
+          "description": "Nome da propriedade do objeto de resultado a ser exibida no input e nas tags."
+        },
+        "searchTitle": {
+          "type": "string",
+          "required": false,
+          "description": "Título do diálogo de pesquisa avançada."
+        },
+        "searchEmptyTitle": {
+          "type": "string",
+          "required": false,
+          "description": "Mensagem exibida quando a pesquisa não retorna resultados."
+        },
+        "filterLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do campo de filtro no diálogo."
+        },
+        "filterTitle": {
+          "type": "string",
+          "required": false,
+          "description": "Título do campo de filtro no diálogo."
+        },
+        "clearLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de limpar filtros."
+        },
+        "cancelLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de cancelar e fechar o diálogo."
+        },
+        "selectLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de confirmar a seleção no diálogo."
+        },
+        "emptyMessage": {
+          "type": "string",
+          "required": false,
+          "description": "Mensagem exibida quando nenhum registro é encontrado na grade."
+        },
+        "recordLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label para um registro (singular)."
+        },
+        "recordsLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label para múltiplos registros (plural)."
+        },
+        "emptyFieldLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label exibida quando o campo está vazio e sem seleção."
+        },
+        "appendTo": {
+          "type": "string",
+          "required": false,
+          "description": "Elemento DOM ao qual o painel de sugestões será anexado.\nUse `'body'` para evitar problemas com `overflow: hidden`."
+        },
+        "autocompleteForceSelection": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o usuário só pode selecionar valores da lista de sugestões;\ntexto livre é descartado ao perder o foco."
+        },
+        "maxlength": {
+          "type": "number | null",
+          "required": false,
+          "description": null
+        },
+        "showAddOption": {
+          "type": "boolean",
+          "required": false,
+          "description": null
+        },
+        "showEditOption": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o botão de editar o registro selecionado."
+        },
+        "showRemoveOption": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o botão de remover registros selecionados."
+        },
+        "sortableColumnsDisabled": {
+          "type": "string[]",
+          "required": false,
+          "description": "Lista de colunas que não podem ser ordenadas na grade do diálogo."
+        },
+        "defaultFilter": {
+          "type": "DefaultFilter[]",
+          "required": false,
+          "description": "Filtros padrão aplicados automaticamente à pesquisa.\nCada item define um campo e um valor fixo ou dinâmico (função).\n\nEstrutura de `DefaultFilter`: `{ field: string; value: string | (() => string); }`",
+          "imports": [
+            "import { DefaultFilter } from '@seniorsistemas/angular-components/dynamic-form';"
+          ]
+        },
+        "onLookupRequest": {
+          "type": "(query: string) => void",
+          "required": true,
+          "description": "Callback chamado quando o usuário digita para buscar sugestões.\nDeve atualizar o `suggestionsObservable` com os resultados da busca."
+        },
+        "onSearchRequest": {
+          "type": "(event: LookupSearchRequest) => void",
+          "required": true,
+          "description": "Callback chamado quando o usuário realiza uma pesquisa no diálogo avançado.\nDeve atualizar o `searchObservable` com os resultados paginados.\n\nEstrutura de `LookupSearchRequest`: `{ filterData: Record<string, any>; first: number; rows: number; }`",
+          "imports": [
+            "import { LookupSearchRequest } from '@seniorsistemas/angular-components/dynamic-form';"
+          ]
+        },
+        "onSelect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário seleciona um registro."
+        },
+        "onUnselect": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário remove um registro selecionado (modo múltiplo)."
+        },
+        "onClear": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário limpa todos os registros selecionados."
+        },
+        "onBlur": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onAdd": {
+          "type": "() => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão de adicionar novo registro."
+        },
+        "onEdit": {
+          "type": "(selectedItem: unknown) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão de editar. Recebe o item selecionado."
+        },
+        "onRemove": {
+          "type": "(selectedItems: unknown[]) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão de remover. Recebe os itens selecionados."
+        },
+        "onClearButtonClick": {
+          "type": "() => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no botão de limpar do campo (X)."
+        }
+      }
+    },
+    "integer": {
+      "interface": "NumberFieldConfig",
+      "sourceFile": "number-field.ts",
+      "description": "Configuração para campos numéricos inteiros ou de número legado.",
+      "ownProperties": {
+        "type": {
+          "type": "'integer' | 'legacyNumber'",
+          "required": true,
+          "description": "`'integer'` — campo numérico inteiro.\n`'legacyNumber'` — campo numérico legado."
+        },
+        "numberLocaleOptions": {
+          "type": "NumberLocaleOptions",
+          "required": false,
+          "description": "Opções de localização numérica."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser."
+        },
+        "precision": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número total de dígitos aceitos. Pode ser função para controle dinâmico."
+        },
+        "scale": {
+          "type": "(() => number) | number",
+          "required": false,
+          "description": "Número de casas decimais. Pode ser função para controle dinâmico."
+        },
+        "alignTo": {
+          "type": "NumberAlignmentOption",
+          "required": false,
+          "description": "Alinhamento do texto no campo."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada. Pode ser string estática ou função."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do campo."
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do campo."
+        },
+        "localizedNumber": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, usa o componente de número localizado."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        }
+      }
+    },
+    "legacyNumber": {
+      "interface": "NumberFieldConfig",
+      "sourceFile": "number-field.ts",
+      "description": "Configuração para campos numéricos inteiros ou de número legado.",
+      "ownProperties": {
+        "type": {
+          "type": "'integer' | 'legacyNumber'",
+          "required": true,
+          "description": "`'integer'` — campo numérico inteiro.\n`'legacyNumber'` — campo numérico legado."
+        },
+        "numberLocaleOptions": {
+          "type": "NumberLocaleOptions",
+          "required": false,
+          "description": "Opções de localização numérica."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser."
+        },
+        "precision": {
+          "type": "Function | number",
+          "required": false,
+          "description": "Número total de dígitos aceitos. Pode ser função para controle dinâmico."
+        },
+        "scale": {
+          "type": "(() => number) | number",
+          "required": false,
+          "description": "Número de casas decimais. Pode ser função para controle dinâmico."
+        },
+        "alignTo": {
+          "type": "NumberAlignmentOption",
+          "required": false,
+          "description": "Alinhamento do texto no campo."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada. Pode ser string estática ou função."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do campo."
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do campo."
+        },
+        "localizedNumber": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, usa o componente de número localizado."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        }
+      }
+    },
+    "password": {
+      "interface": "PasswordFieldConfig",
+      "sourceFile": "password-field.ts",
+      "description": "Configuração para campo de senha com indicador de força.\n\nRenderiza um input de senha com:\n- Togglear a visibilidade da senha (mostrar/ocultar)\n- Indicador visual de força da senha (fraca/média/forte)\n- Configuração customizada das regras de validação da força",
+      "ownProperties": {
+        "type": {
+          "type": "'password'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'password'`."
+        },
+        "inputType": {
+          "type": "string",
+          "required": false,
+          "description": "Tipo HTML do input."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas. Aceita regex, string ou qualquer valor aceito pelo componente."
+        },
+        "maxLength": {
+          "type": "string | number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos."
+        },
+        "passwordStrength": {
+          "type": "boolean",
+          "required": true,
+          "description": "Quando `true`, exibe a barra de força da senha abaixo do campo.\nRequer `passwordStrengthOptions` para personalizar as regras de avaliação."
+        },
+        "passwordStrengthOptions": {
+          "type": "PasswordStrengthOptions",
+          "required": false,
+          "description": "Opções de configuração da barra de força da senha.\nObrigatório quando `passwordStrength: true`."
+        },
+        "showToggle": {
+          "type": "boolean",
+          "required": true,
+          "description": "Quando `true`, exibe o botão de alternar visibilidade da senha (olho/olho fechado)."
+        },
+        "style": {
+          "type": "{\n    [klass: string]: any;\n}",
+          "required": false,
+          "description": "Estilos CSS inline aplicados ao elemento de input."
+        },
+        "onBlur": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        }
+      }
+    },
+    "profilePicture": {
+      "interface": "ProfilePictureConfig",
+      "sourceFile": "profile-picture.ts",
+      "description": "Configuração para campo de foto de perfil com recorte.\n\nExibe uma área para upload e recorte de imagem de perfil.\nSuporta pré-visualização, recorte interativo (cropper), validação de tipo e tamanho,\nconfirmação de remoção e labels customizadas para todas as ações.",
+      "ownProperties": {
+        "type": {
+          "type": "'profilePicture'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'profilePicture'`."
+        },
+        "simpleTitle": {
+          "type": "string",
+          "required": true,
+          "description": "Título exibido no modo simples (sem imagem carregada)."
+        },
+        "actionTitle": {
+          "type": "string",
+          "required": true,
+          "description": "Título exibido quando o painel de ações está ativo (com imagem carregada)."
+        },
+        "subtitle": {
+          "type": "string",
+          "required": true,
+          "description": "Subtexto descritivo exibido abaixo do título."
+        },
+        "aspectRatio": {
+          "type": "number",
+          "required": true,
+          "description": "Proporção de aspecto da área de recorte (largura / altura)."
+        },
+        "cropperLabelsConfig": {
+          "type": "CropperLabelsConfig",
+          "required": false,
+          "description": "Labels dos botões exibidos no diálogo do cropper.\nImportado de `@seniorsistemas/angular-components/profile-picture-picker`."
+        },
+        "removeButtonLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de remover a imagem atual."
+        },
+        "changeButtonLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de alterar a imagem atual."
+        },
+        "confirmationTexts": {
+          "type": "ConfirmationTexts",
+          "required": false,
+          "description": "Textos de confirmação exibidos no diálogo de remoção da imagem."
+        },
+        "maxFileSize": {
+          "type": "number",
+          "required": false,
+          "description": "Tamanho máximo do arquivo aceito em bytes."
+        },
+        "accept": {
+          "type": "string",
+          "required": false,
+          "description": "Tipos MIME aceitos."
+        },
+        "supportedExtensions": {
+          "type": "string[]",
+          "required": false,
+          "description": "Extensões de arquivo aceitas (com ponto)."
+        },
+        "onChangeImage": {
+          "type": "(event: string | ProfilePicturePickerData) => void",
+          "required": false,
+          "description": "Callback chamado quando a imagem é alterada após o recorte.\nRecebe a imagem em base64 ou objeto `ProfilePicturePickerData`."
+        },
+        "onRemovedImage": {
+          "type": "() => void",
+          "required": false,
+          "description": "Callback chamado quando a imagem é removida pelo usuário."
+        },
+        "onInvalidFile": {
+          "type": "(event: FileValidationErrors) => void",
+          "required": false,
+          "description": "Callback chamado quando o arquivo selecionado não passa na validação.\nRecebe os erros de validação ocorridos (ex: tamanho, extensão)."
+        }
+      }
+    },
+    "radioButton": {
+      "interface": "RadioButtonFieldConfig",
+      "sourceFile": "radio-button-field.ts",
+      "description": "Configuração para campo de seleção única com radio buttons.\n\nExibe um grupo de radio buttons onde o usuário pode selecionar exatamente uma opção.\nA lista de opções é definida estaticamente via `options`.\n\nUse quando o número de opções é pequeno (até ~5 itens) e todas devem estar visíveis.\nPara listas longas, prefira `type: 'enum'` com dropdown.",
+      "ownProperties": {
+        "type": {
+          "type": "'radioButton'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'radioButton'`."
+        },
+        "verticalAlignment": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, os radio buttons são exibidos verticalmente (empilhados).\nPor padrão, são exibidos horizontalmente."
+        },
+        "clearLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label do botão de limpar a seleção. Exibido quando `showClear: true`."
+        },
+        "options": {
+          "type": "RationButtonOption[]",
+          "required": true,
+          "description": "Lista de opções disponíveis para seleção. Obrigatório."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica em uma opção."
+        },
+        "showClear": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe um botão para limpar a seleção atual.\nO texto do botão é definido em `clearLabel`."
+        }
+      }
+    },
+    "enum": {
+      "interface": "SelectFieldConfig",
+      "sourceFile": "select-field.ts",
+      "description": "Configuração para campo de seleção (dropdown/select).\n\nExibe um dropdown com lista de opções estáticas ou dinâmicas.\nSuporta seleção múltipla, filtro de pesquisa, opções editadas, grupos hierárquicos\ne badges coloridos por opção.\n\nPara listas grandes com busca no servidor, prefira `type: 'autocomplete'` ou `type: 'lookup'`.",
+      "ownProperties": {
+        "type": {
+          "type": "'enum'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'enum'`."
+        },
+        "optionLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Nome da propriedade do objeto de opção usada como label visível."
+        },
+        "optionValue": {
+          "type": "string",
+          "required": false,
+          "description": "Nome da propriedade do objeto de opção usada como valor armazenado."
+        },
+        "dataKey": {
+          "type": "string",
+          "required": false,
+          "description": "Chave única identificadora de cada opção. Usada para rastrear seleção corretamente."
+        },
+        "autoDisplayFirst": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, a primeira opção da lista é selecionada automaticamente."
+        },
+        "options": {
+          "type": "selectOptionFn | SelectOption[]",
+          "required": true,
+          "description": "Lista de opções disponíveis. Pode ser um array estático ou uma função que retorna o array.\nCada opção pode ter `label`, `value`, `items` (subgrupo) e `badge`."
+        },
+        "multiple": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, permite selecionar múltiplas opções.\nO valor do campo será um array."
+        },
+        "multipleSelectedLabel": {
+          "type": "string",
+          "required": false,
+          "description": "Label exibida no campo quando múltiplas opções forem selecionadas."
+        },
+        "onClick": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário clica no dropdown."
+        },
+        "onChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o valor selecionado muda."
+        },
+        "emptyMessage": {
+          "type": "string",
+          "required": false,
+          "description": "Mensagem exibida quando a lista está vazia ou a pesquisa não retorna resultados."
+        },
+        "editable": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o campo se torna um combobox editável, permitindo digitar um valor livre\nalém das opções da lista."
+        },
+        "filter": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe um campo de pesquisa interno no dropdown para filtrar as opções."
+        },
+        "group": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, agrupa as opções por categoria usando a propriedade `items` de cada opção."
+        },
+        "showClear": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe um botão de limpar a seleção (X) no campo."
+        }
+      }
+    },
+    "slider": {
+      "interface": "SliderFieldConfig",
+      "sourceFile": "slider-field.ts",
+      "description": "Configuração para campo de controle deslizante (slider).\n\nExibe um slider interativo para seleção de valor numérico dentro de um intervalo.\nSuporta modo de intervalo (range) com dois pontos de seleção, orientação\nhorizontal/vertical, step configurado e exibição de prefixo/sufixo.",
+      "ownProperties": {
+        "type": {
+          "type": "'slider'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'slider'`."
+        },
+        "onChange": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado enquanto o usuário arrastar o slider (alteração contínua)."
+        },
+        "onSlideEnd": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado quando o usuário solta o slider (fim do arraste)."
+        },
+        "range": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe dois pontos de seleção para definir um intervalo (min-max).\nO valor do campo será um array `[min, max]` em vez de um número único."
+        },
+        "min": {
+          "type": "number",
+          "required": false,
+          "description": "Valor mínimo do slider."
+        },
+        "max": {
+          "type": "number",
+          "required": false,
+          "description": "Valor máximo do slider."
+        },
+        "step": {
+          "type": "number",
+          "required": false,
+          "description": "Incremento de cada passo ao mover o slider."
+        },
+        "orientation": {
+          "type": "'horizontal' | 'vertical'",
+          "required": true,
+          "description": "Orientação do slider.\n`'horizontal'` — slider na horizontal (padrão).\n`'vertical'` — slider na vertical."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, o slider fica desabilitado (não interativo e sem alteração de valor)."
+        },
+        "prefix": {
+          "type": "string",
+          "required": false,
+          "description": "Texto exibido antes do valor do slider (ex: `'R$'`, `'>'`)."
+        },
+        "suffix": {
+          "type": "string",
+          "required": false,
+          "description": "Texto exibido após o valor do slider (ex: `'km'`, `'%'`)."
+        },
+        "rangeSeparator": {
+          "type": "string",
+          "required": false,
+          "description": "Texto exibido entre os dois valores quando `range: true`."
+        },
+        "defaultValue": {
+          "type": "any",
+          "required": false,
+          "description": "Valor inicial do slider ao renderizar o formulário.\nPara modo range, passe um array `[min, max]`."
+        }
+      }
+    },
+    "starRating": {
+      "interface": "StarRatingFieldConfig",
+      "sourceFile": "star-rating-field.ts",
+      "description": "Configuração para campo de avaliação com estrelas.\n\nRenderiza um componente de rating visual com estrelas clicáveis.\nO valor do campo é um número inteiro correspondente à estrela selecionada.",
+      "ownProperties": {
+        "type": {
+          "type": "'starRating'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'starRating'`."
+        },
+        "starRange": {
+          "type": "number",
+          "required": true,
+          "description": "Número total de estrelas exibidas."
+        },
+        "disabled": {
+          "type": "boolean | booleanFn",
+          "required": true,
+          "description": "Quando `true` ou função que retorna `true`, o componente fica desabilitado (somente leitura).\nUse função para controle dinâmico baseado no estado do formulário."
+        },
+        "justifyContent": {
+          "type": "JustifyTypes",
+          "required": false,
+          "description": "Alinhamento horizontal das estrelas dentro da célula do formulário.\nImportado de `@seniorsistemas/angular-components/star-rating`."
+        },
+        "valueChange": {
+          "type": "(star: number) => any",
+          "required": false,
+          "description": "Callback chamado quando a estrela selecionada muda.\nRecebe o valor numérico da estrela clicada."
+        }
+      }
+    },
+    "textArea": {
+      "interface": "TextAreaFieldConfig",
+      "sourceFile": "text-area-field.ts",
+      "description": "Configuração para campo de área de texto multilinha.\n\nExibe um textarea com suporte a reconhecimento de voz, controle de linhas/colunas,\nmodo somente-leitura e limite de caracteres.\n\nPara funcionalidades de geração de texto por IA, use `type: 'contentGenerator'`.",
+      "ownProperties": {
+        "type": {
+          "type": "'textArea'",
+          "required": true,
+          "description": "Tipo do campo: sempre `'textArea'`."
+        },
+        "cols": {
+          "type": "number",
+          "required": false,
+          "description": "Número de colunas de texto do textarea (largura)."
+        },
+        "rows": {
+          "type": "number",
+          "required": false,
+          "description": "Número de linhas visíveis do textarea (altura inicial)."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas no campo. Aceita regex ou string."
+        },
+        "style": {
+          "type": "Partial<CSSStyleDeclaration>",
+          "required": false,
+          "description": "Estilos CSS inline aplicados diretamente no elemento textarea."
+        },
+        "readonly": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna `true` quando o campo deve estar em modo somente-leitura."
+        },
+        "speechRecognition": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, exibe o botão de reconhecimento de voz (speech-to-text)."
+        },
+        "keepContext": {
+          "type": "boolean",
+          "required": false,
+          "description": "Quando `true`, mantém o contexto das interações anteriores de voz/IA."
+        },
+        "speechRecognitionPlaceholder": {
+          "type": "string",
+          "required": false,
+          "description": "Texto de placeholder exibido na área de reconhecimento de voz enquanto o microfone está ativo."
+        },
+        "maxLength": {
+          "type": "number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos no campo."
+        }
+      }
+    },
+    "string": {
+      "interface": "TextFieldConfig",
+      "sourceFile": "text-field.ts",
+      "description": "Configuração para campos de texto simples.\n\nUse `type: 'string'` para texto livre geral.\nUse `type: 'binary'` para campos que armazenam dados binários como texto (ex: base64).\n\nSuporta máscaras de entrada, addons laterais, filtro de caracteres e eventos do input.",
+      "ownProperties": {
+        "type": {
+          "type": "'string' | 'binary'",
+          "required": true,
+          "description": "`'string'` — campo de texto livre padrão.\n`'binary'` — campo de texto tratado como dado binário (ex: base64 encoding)."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada aplicada ao campo. Pode ser uma string fixa ou uma função que retorna a máscara dinamicamente.\nExemplo de máscara: `'999.999.999-99'` (CPF), `'(99) 99999-9999'` (telefone).\nQuando definida, `leftAddon` e `rightAddon` não funcionam."
+        },
+        "readonly": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna `true` quando o campo deve estar em modo somente-leitura.\nUse uma função para controle dinâmico baseado no estado do formulário."
+        },
+        "characterPattern": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Padrão regex para filtrar os caracteres permitidos na digitação.\nPode ser uma string de pattern ou uma função que retorna o padrão.\nExemplo: `'[a-zA-Z]'` permite apenas letras."
+        },
+        "unmask": {
+          "type": "booleanFn | boolean",
+          "required": false,
+          "description": "Quando `true`, remove os caracteres da máscara do valor enviado ao modelo.\nExemplo: com máscara CPF `'999.999.999-99'`, o valor armazenado será apenas os dígitos."
+        },
+        "inputType": {
+          "type": "string",
+          "required": false,
+          "description": "Tipo HTML do input (ex: `'text'`, `'email'`, `'tel'`, `'url'`).\nAfeta o teclado exibido em dispositivos móveis e a validação nativa do browser."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas no campo. Aceita uma expressão regular ou string.\nExemplo: `/[0-9]/` para aceitar apenas números."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do input (ex: ícone, texto, botão).\n**Não funciona quando `mask` está definida.**"
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do input (ex: ícone, texto, botão).\n**Não funciona quando `mask` está definida.**"
+        },
+        "maxLength": {
+          "type": "string | number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos no campo."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser.\n`true` ativa o autocomplete; `false` desativa."
+        },
+        "style": {
+          "type": "{\n    [klass: string]: any;\n}",
+          "required": false,
+          "description": "Estilos CSS inline aplicados diretamente no elemento de input."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        }
+      }
+    },
+    "binary": {
+      "interface": "TextFieldConfig",
+      "sourceFile": "text-field.ts",
+      "description": "Configuração para campos de texto simples.\n\nUse `type: 'string'` para texto livre geral.\nUse `type: 'binary'` para campos que armazenam dados binários como texto (ex: base64).\n\nSuporta máscaras de entrada, addons laterais, filtro de caracteres e eventos do input.",
+      "ownProperties": {
+        "type": {
+          "type": "'string' | 'binary'",
+          "required": true,
+          "description": "`'string'` — campo de texto livre padrão.\n`'binary'` — campo de texto tratado como dado binário (ex: base64 encoding)."
+        },
+        "mask": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Máscara de entrada aplicada ao campo. Pode ser uma string fixa ou uma função que retorna a máscara dinamicamente.\nExemplo de máscara: `'999.999.999-99'` (CPF), `'(99) 99999-9999'` (telefone).\nQuando definida, `leftAddon` e `rightAddon` não funcionam."
+        },
+        "readonly": {
+          "type": "() => boolean",
+          "required": false,
+          "description": "Função que retorna `true` quando o campo deve estar em modo somente-leitura.\nUse uma função para controle dinâmico baseado no estado do formulário."
+        },
+        "characterPattern": {
+          "type": "stringFn | string",
+          "required": false,
+          "description": "Padrão regex para filtrar os caracteres permitidos na digitação.\nPode ser uma string de pattern ou uma função que retorna o padrão.\nExemplo: `'[a-zA-Z]'` permite apenas letras."
+        },
+        "unmask": {
+          "type": "booleanFn | boolean",
+          "required": false,
+          "description": "Quando `true`, remove os caracteres da máscara do valor enviado ao modelo.\nExemplo: com máscara CPF `'999.999.999-99'`, o valor armazenado será apenas os dígitos."
+        },
+        "inputType": {
+          "type": "string",
+          "required": false,
+          "description": "Tipo HTML do input (ex: `'text'`, `'email'`, `'tel'`, `'url'`).\nAfeta o teclado exibido em dispositivos móveis e a validação nativa do browser."
+        },
+        "keyFilter": {
+          "type": "any",
+          "required": false,
+          "description": "Filtro de teclas aceitas no campo. Aceita uma expressão regular ou string.\nExemplo: `/[0-9]/` para aceitar apenas números."
+        },
+        "leftAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à esquerda do input (ex: ícone, texto, botão).\n**Não funciona quando `mask` está definida.**"
+        },
+        "rightAddon": {
+          "type": "AddonConfig",
+          "required": false,
+          "description": "Addon exibido à direita do input (ex: ícone, texto, botão).\n**Não funciona quando `mask` está definida.**"
+        },
+        "maxLength": {
+          "type": "string | number",
+          "required": false,
+          "description": "Número máximo de caracteres permitidos no campo."
+        },
+        "browserAutocomplete": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controla o autocomplete nativo do browser.\n`true` ativa o autocomplete; `false` desativa."
+        },
+        "style": {
+          "type": "{\n    [klass: string]: any;\n}",
+          "required": false,
+          "description": "Estilos CSS inline aplicados diretamente no elemento de input."
+        },
+        "onBlur": {
+          "type": "(event: Event) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo perde o foco."
+        },
+        "onFocus": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando o campo recebe foco."
+        },
+        "onComplete": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado quando a máscara é completamente preenchida."
+        },
+        "onInput": {
+          "type": "(event: FocusEvent) => void",
+          "required": false,
+          "description": "Callback chamado a cada alteração no valor do input."
+        }
+      }
+    }
+  },
+  "structureTypes": {
+    "fieldset": {
+      "interface": "FieldsetConfig",
+      "sourceFile": "fieldset.ts",
+      "description": "Configuração para estrutura do tipo fieldset (grupo recolhível).\n\nAgrupa campos dentro de um painel que pode ser expandido ou recolhido pelo usuário.\nÚtil para separar logicamente seções opcionais ou detalhes avançados do formulário.",
+      "ownProperties": {
+        "type": {
+          "type": "'fieldset'",
+          "required": true,
+          "description": "Tipo da estrutura: sempre `'fieldset'`."
+        },
+        "beforeToggle": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado antes de o painel ser expandido ou recolhido.\nPode ser usado para cancelar a ação ou realizar operações prévias."
+        },
+        "afterToggle": {
+          "type": "(event: any) => void",
+          "required": false,
+          "description": "Callback chamado após o painel ser expandido ou recolhido."
+        }
+      }
+    },
+    "row": {
+      "interface": "RowConfig",
+      "sourceFile": "row.ts",
+      "description": "Configuração para estrutura do tipo linha (row).\n\nOrganiza campos lado a lado em uma linha horizontal usando grid layout.\nCada campo dentro de um `row` pode receber propriedades adicionais de `RowAdditionalFields`,\ncomo `size`, `visible`, `errorMessages`, `footer` e `bottomTemplate`.",
+      "ownProperties": {
+        "type": {
+          "type": "'row'",
+          "required": true,
+          "description": "Tipo da estrutura: sempre `'row'`."
+        },
+        "fields": {
+          "type": "RowType[]",
+          "required": true,
+          "description": "Lista de campos e sub-estruturas dispostos em linha.\nCada item pode ter propriedades adicionais de `RowAdditionalFields` (size, visible, footer, etc.)."
+        },
+        "visible": {
+          "type": "booleanFn | boolean",
+          "required": false,
+          "description": "Controla a visibilidade da linha inteira.\nPode ser um booleano estático ou função reativa."
+        }
+      },
+      "rowAdditionalFields": {
+        "description": "Extra properties available on every field/structure placed inside a row (via ExpandedDynamicType / ExpandedDynamicStructure).",
+        "properties": {
+          "size": {
+            "type": "FieldSizeConfig",
+            "required": false,
+            "description": "Tamanho (largura) deste campo dentro da linha.\nPermite definir colunas responsivas (ex: metade da linha, terço, etc.)\nusando `FieldSizeConfig` com breakpoints."
+          },
+          "visible": {
+            "type": "() => boolean",
+            "required": false,
+            "description": "Função que retorna `true` quando o campo deve ser exibido.\nPermite ocultar/exibir o campo dinamicamente sem removê-lo da configuração."
+          },
+          "errorMessages": {
+            "type": "() => {} | {}",
+            "required": false,
+            "description": "Função que retorna um mapa de mensagens de erro customizadas para o campo.\nA chave é o nome do validador (ex: `'required'`, `'minlength'`) e o valor é a mensagem."
+          },
+          "bottomTemplate": {
+            "type": "TemplateRef<Element>",
+            "required": false,
+            "description": "Template Angular (`ng-template`) renderizado abaixo do campo.\nUse para adicionar conteúdo customizado abaixo do input, como dicas ou informações extras."
+          },
+          "footer": {
+            "type": "{\n    help?: {\n        text: string;\n        visible?: (options: {\n            abstractControl: AbstractControl;\n            formField: DynamicType;\n        }) => boolean;\n    };\n    link?: {\n        label: string;\n        onClick?: (options: {\n            abstractControl: AbstractControl;\n            formField: DynamicType;\n        }) => void;\n        visible?: (options: {\n            abstractControl: AbstractControl;\n            formField: DynamicType;\n        }) => boolean;\n    };\n}",
+            "required": false,
+            "description": "Rodapé exibido abaixo do campo com texto de ajuda e/ou link de ação.\nPermite adicionar orientações contextuais ou atalhos diretamente associados ao campo."
+          }
+        }
+      }
+    },
+    "section": {
+      "interface": "SectionConfig",
+      "sourceFile": "section.ts",
+      "description": "Configuração para estrutura do tipo seção.\n\nÉ o container principal do DynamicForm, agrupa campos e outras estruturas.\nSuporta layout flexbox para controlar disposição dos filhos com `isFlex`,\n`justifyContent` e `alignItems`.",
+      "ownProperties": {
+        "type": {
+          "type": "'section'",
+          "required": true,
+          "description": "Tipo da estrutura: sempre `'section'`."
+        },
+        "isFlex": {
+          "type": "boolean",
+          "required": false,
+          "description": "Define if the structure is a flex container."
+        },
+        "justifyContent": {
+          "type": "'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly'",
+          "required": false,
+          "description": "Define the justify-content property."
+        },
+        "alignItems": {
+          "type": "'stretch' | 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'initial' | 'inherit'",
+          "required": false,
+          "description": "Define the align-items property."
+        }
+      }
+    }
+  },
+  "optionalFieldTypes": {
+    "editor": {
+      "interface": "EditorFieldConfig",
+      "sourceFile": "optional-fields/editor/editor-field.ts",
+      "description": "Configuração fornecida ao instanciar um campo do tipo 'editor'.\nUtilizado para renderizar um editor de rich text (wysiwyg).",
+      "ownProperties": {
+        "type": {
+          "type": "'editor'",
+          "required": true,
+          "description": "Define o tipo único deste campo opcional."
+        },
+        "formats": {
+          "type": "string[]",
+          "required": false,
+          "description": "Formatos suportados pelo editor (ex: 'bold', 'italic')."
+        },
+        "readonly": {
+          "type": "boolean",
+          "required": false,
+          "description": "Define se o editor estará apenas em modo leitura."
+        },
+        "modules": {
+          "type": "any",
+          "required": false,
+          "description": "Módulos adicionais do QuillJS a serem ativados no editor."
+        },
+        "style": {
+          "type": "{\n    [klass: string]: unknown;\n}",
+          "required": false,
+          "description": "Estilos customizados aplicados diretamente no container do editor."
+        }
+      },
+      "provider": "provideEditorField()",
+      "providerFunction": "provideEditorField",
+      "providerImport": "import { provideEditorField } from '@seniorsistemas/angular-components/optional-fields/editor';",
+      "package": "@seniorsistemas/angular-components/optional-fields/editor"
+    }
+  }
+}