@praxisui/dynamic-form 9.0.0-beta.13 → 9.0.0-beta.14

package/README.md

@@ -101,6 +101,38 @@ For schema-driven backend surfaces, prefer explicit `schemaUrl`, `submitUrl`, an
 
 When using resource, schema, read, or submit flows, the host must provide the effective API/CRUD service wiring for that scope.
 
+For fields published by the backend schema, server DTO metadata remains authoritative for semantic presentation data such as `label`, `hint`, `helpText`, `tooltip`, `tooltipOnHover`, and icon metadata. Local `FormConfig` should customize layout, grouping, transient fields, actions, and host-specific behavior, but it should not redefine DTO-owned field semantics.
+
+Example backend-owned `x-ui` metadata:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "frequencyType": {
+      "type": "string",
+      "x-ui": {
+        "label": "Frequency type",
+        "controlType": "async-select",
+        "helpText": "Select the operational class used by payroll and timekeeping rules.",
+        "tooltip": "Backend-owned DTO semantics; local FormConfig cannot override it.",
+        "tooltipOnHover": true,
+        "icon": "calendar_month",
+        "iconPosition": "start",
+        "iconColor": "primary",
+        "endpoint": "/api/frequency-types/options/filter",
+        "filterField": "name",
+        "sortField": "name",
+        "sortOrder": "asc",
+        "optionsPageSize": 20
+      }
+    }
+  }
+}
+```
+
+In that flow, local `FormConfig` may place `frequencyType` in sections, rows, tabs, custom actions, or corporate-only local fields. It should not persist competing `label`, `helpText`, `tooltip`, or icon metadata for `frequencyType`, because the next schema reconciliation will restore the backend DTO semantics.
+
 ## Runtime Inputs And Outputs
 
 Common inputs:

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-06-22T22:56:44.148Z",
+  "generatedAt": "2026-06-24T01:01:47.814Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.0-beta.13",
+  "packageVersion": "9.0.0-beta.14",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -2356,6 +2356,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "fieldMetadata[].helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "fieldMetadata[].tooltip",
           "category": "identity",
@@ -2365,6 +2375,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "fieldMetadata[].tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "fieldMetadata[].description",
           "category": "identity",
@@ -2689,6 +2709,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "fieldMetadata[].iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "fieldMetadata[].mask",
           "category": "appearance",
@@ -7891,9 +7951,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: metadata.version\n    Category: metadata\n    Kind: string\n    Description: Versão da configuração do formulário para controle de migração.\n  - Path: metadata.source\n    Category: metadata\n    Kind: enum\n    Description: Origem da configuração do formulário.\n  - Path: metadata.lastUpdated\n    Category: metadata\n    Kind: string\n    Description: Timestamp da última atualização da configuração (ISO-8601).\n  - Path: metadata.schemaId\n    Category: metadata\n    Kind: string\n    Description: ID do schema de origem para reconciliação no servidor.\n  - Path: metadata.schemaContext\n    Category: metadata\n    Kind: object\n    Description: Contexto do schema usado para compor o formulário.\n  - Path: metadata.schemaContext.path\n    Category: metadata\n    Kind: string\n    Description: Path do schema de origem.\n  - Path: metadata.schemaContext.operation\n    Category: metadata\n    Kind: string\n    Description: Operação do schema (ex.: \"get\", \"post\").\n  - Path: metadata.schemaContext.schemaType\n    Category: metadata\n    Kind: enum\n    Description: Tipo do schema (response/request).\n  - Path: metadata.schemaContext.internal\n    Category: metadata\n    Kind: boolean\n    Description: Indica se o schema é interno.\n  - Path: metadata.schemaContext.tenant\n    Category: metadata\n    Kind: string\n    Description: Tenant do schema (se aplicável).\n  - Path: metadata.schemaContext.locale\n    Category: metadata\n    Kind: string\n    Description: Locale do schema (se aplicável).\n  - Path: metadata.serverHash\n    Category: metadata\n    Kind: string\n    Description: Hash dos dados do servidor para detecção de mudanças.\n  - Path: metadata.customizations\n    Category: metadata\n    Kind: array\n    Description: Log de customizações manuais aplicadas ao formulário.\n  - Path: fieldMetadata\n    Category: fields\n    Kind: array\n    Description: Array de metadados dos campos. Usado para referenciar a configuração de campos.\n  - Path: fieldMetadata[]\n    Category: fields\n    Kind: object\n    Description: Item de metadados do campo (FieldMetadata).\n  - Path: editorialContext\n    Category: editorial\n    Kind: object\n    Description: Contexto editorial compartilhado entre os blocos hospedados antes/depois do formulario.\n  - Path: editorialContext.[token]\n    Category: editorial\n    Kind: string\n    Description: Valor simples exposto no contexto editorial.\n  - Path: formBlocksBefore\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado antes do formulario.\n  - Path: formBlocksBefore.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content.\n  - Path: formBlocksBefore.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content editorial.\n  - Path: formBlocksBefore.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes do formulario.\n  - Path: formBlocksBefore.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes do formulario.\n  - Path: formBlocksBefore.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content hospedado antes do formulario.\n  - Path: formBlocksBeforeActions\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois das seções e antes da área principal de ações.\n  - Path: formBlocksBeforeActions.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes da área principal de ações.\n  - Path: formBlocksBeforeActions.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes da área principal de ações.\n  - Path: formBlocksBeforeActions.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content antes das ações.\n  - Path: formBlocksAfter\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois do formulario inteiro, incluindo a área principal de ações.\n  - Path: formBlocksAfter.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content de fechamento.\n  - Path: formBlocksAfter.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content de fechamento.\n  - Path: formBlocksAfter.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados depois do formulario.\n  - Path: formBlocksAfter.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado depois do formulario.\n  - Path: formBlocksAfter.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content de fechamento.\n  - Path: sections[].id\n    Category: layout\n    Kind: string\n    Description: ID único da seção.\n  - Path: sections[].title\n    Category: layout\n    Kind: string\n    Description: Título exibido para cada seção do formulário.\n  - Path: sections[].description\n    Category: layout\n    Kind: string\n    Description: Descrição auxiliar exibida abaixo do título da seção.\n  - Path: sections[].icon\n    Category: layout\n    Kind: string\n    Description: Nome do ícone (Material Icons) para o cabeçalho da seção.\n  - Path: sections[].sectionHeader\n    Category: layout\n    Kind: object\n    Description: Configuração rica do header visual da seção, com suporte a avatar por imagem, iniciais ou modo automático.\n  - Path: sections[].sectionHeader.mode\n    Category: layout\n    Kind: enum\n    Description: Estratégia visual do header da seção.\n  - Path: sections[].sectionHeader.sourceField\n    Category: layout\n    Kind: string\n    Description: Campo do formulário usado como origem da imagem do avatar.\n  - Path: sections[].sectionHeader.initialsSourceField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado para derivar iniciais do avatar.\n  - Path: sections[].sectionHeader.altField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado como texto acessivel do avatar e como fallback textual para iniciais quando initialsSourceField nao estiver definido.\n  - Path: sections[].sectionHeader.fallbackIcon\n    Category: layout\n    Kind: string\n    Description: Ícone opcional usado quando o avatar dinâmico estiver vazio ou inválido.\n  - Path: sections[].sectionHeader.emptyState\n    Category: layout\n    Kind: enum\n    Description: Comportamento do header quando os campos de origem ainda não possuem valor.\n  - Path: sections[].sectionHeader.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semântico do avatar da seção, materializado pelo runtime via tokens.\n  - Path: sections[].sectionHeader.initialsMaxLength\n    Category: layout\n    Kind: number\n    Description: Máximo de letras exibidas no avatar textual.\n  - Path: sections[].collapsible\n    Category: layout\n    Kind: boolean\n    Description: Define se a seção pode ser colapsada/expandida pelo usuário.\n  - Path: sections[].collapsed\n    Category: layout\n    Kind: boolean\n    Description: Estado inicial da seção (colapsada/expandida) quando `collapsible` é true.\n  - Path: sections[].gapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após a seção.\n  - Path: sections[].titleGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo do título da seção.\n  - Path: sections[].descriptionGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo da descrição da seção.\n  - Path: sections[].appearance\n    Category: appearance\n    Kind: enum\n    Description: Preset visual do container/cabeçalho da seção.\n  - Path: sections[].stepLabel\n    Category: content\n    Kind: string\n    Description: Rótulo curto do passo exibido antes do título da seção.\n  - Path: sections[].titleStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para o título da seção.\n  - Path: sections[].descriptionStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para a descrição da seção.\n  - Path: sections[].titleColor\n    Category: appearance\n    Kind: string\n    Description: Cor do título da seção (CSS color ou token).\n  - Path: sections[].descriptionColor\n    Category: appearance\n    Kind: string\n    Description: Cor da descrição da seção (CSS color ou token).\n  - Path: sections[].headerAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento horizontal do conteúdo do cabeçalho da seção.\n  - Path: sections[].headerTooltip\n    Category: layout\n    Kind: string\n    Description: Texto de tooltip para o cabeçalho da seção.\n  - Path: sections[].headerActions\n    Category: layout\n    Kind: array\n    Description: Lista de ações iconográficas renderizadas no canto direito do cabeçalho da seção.\n  - Path: sections[].headerActions[].id\n    Category: layout\n    Kind: string\n    Description: ID estável da ação de cabeçalho da seção.\n  - Path: sections[].headerActions[].label\n    Category: layout\n    Kind: string\n    Description: Label acessível usada em tooltip e aria-label da ação.\n  - Path: sections[].headerActions[].icon\n    Category: layout\n    Kind: string\n    Description: Ícone renderizado na ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].action\n    Category: layout\n    Kind: string\n    Description: Nome opcional da ação emitida no customAction; se ausente, o runtime usa o ID.\n  - Path: sections[].headerActions[].tooltip\n    Category: layout\n    Kind: string\n    Description: Tooltip opcional da ação; se ausente, o runtime usa a label.\n  - Path: sections[].headerActions[].color\n    Category: appearance\n    Kind: enum\n    Description: Tom visual da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].visible\n    Category: layout\n    Kind: boolean\n    Description: Controla a visibilidade da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].disabled\n    Category: layout\n    Kind: boolean\n    Description: Controla o estado desabilitado da ação do cabeçalho da seção.\n  - Path: sections[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da seção.\n  - Path: sections[].styles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da seção.\n  - Path: sections[].rows[].id\n    Category: layout\n    Kind: string\n    Description: ID único da linha dentro de uma seção.\n  - Path: sections[].rows[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da linha (usado em editores e labels).\n  - Path: sections[].rows[].gap\n    Category: layout\n    Kind: number\n    Description: Espaçamento horizontal (em px) entre colunas nesta linha.\n  - Path: sections[].rows[].rowGap\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após esta linha.\n  - Path: sections[].rows[].columns[].id\n    Category: layout\n    Kind: string\n    Description: ID único da coluna dentro de uma linha.\n  - Path: sections[].rows[].columns[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da coluna (usado em editores e labels).\n  - Path: sections[].rows[].columns[].testId\n    Category: layout\n    Kind: string\n    Description: Atributo data-testid aplicado ao container da coluna.\n  - Path: sections[].rows[].columns[].fields\n    Category: layout\n    Kind: array\n    Description: Projeção legada/derivada dos itens kind:\"field\" dentro da coluna.\n  - Path: sections[].rows[].columns[].fields[]\n    Category: layout\n    Kind: string\n    Description: Nome do campo dentro da projeção legada/derivada da coluna.\n  - Path: sections[].rows[].columns[].items\n    Category: layout\n    Kind: array\n    Description: Lista canônica ordenada de itens da coluna: campos e blocos visuais.\n  - Path: sections[].rows[].columns[].items[].kind\n    Category: layout\n    Kind: enum\n    Description: Tipo do item de layout da coluna.\n  - Path: sections[].rows[].columns[].items[].id\n    Category: layout\n    Kind: string\n    Description: ID estável do item de layout dentro do formulário.\n  - Path: sections[].rows[].columns[].items[].fieldName\n    Category: layout\n    Kind: string\n    Description: Nome do campo quando kind é \"field\".\n  - Path: sections[].rows[].columns[].items[].document\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument do bloco visual quando kind é \"richContent\".\n  - Path: sections[].rows[].columns[].items[].layout\n    Category: editorial\n    Kind: enum\n    Description: Modo de renderização do bloco visual richContent dentro da coluna.\n  - Path: sections[].rows[].columns[].items[].rootClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS opcional aplicada ao bloco visual richContent.\n  - Path: sections[].rows[].columns[].span.xs\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.sm\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.md\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.lg\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.xl\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xs\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.sm\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.md\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.lg\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xl\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].order.xs\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].order.sm\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].order.md\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].order.lg\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].order.xl\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].hidden.xs\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].hidden.sm\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].hidden.md\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].hidden.lg\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].hidden.xl\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].align\n    Category: layout\n    Kind: enum\n    Description: Alinhamento vertical do conteúdo da coluna.\n  - Path: sections[].rows[].columns[].padding\n    Category: layout\n    Kind: number\n    Description: Padding (em px) interno da coluna.\n  - Path: sections[].rows[].columns[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada à coluna.\n  - Path: actions.submit.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de submissão.\n  - Path: actions.submit.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de submissão.\n  - Path: actions.submit.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de submissão.\n  - Path: actions.submit.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de submissão.\n  - Path: actions.submit.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de submissão.\n  - Path: actions.submit.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de submissão.\n  - Path: actions.submit.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de submissão.\n  - Path: actions.submit.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de submissão.\n  - Path: actions.submit.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de submissão.\n  - Path: actions.submit.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de submissão.\n  - Path: actions.submit.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de submissão.\n  - Path: actions.submit.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.submit.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de submissão.\n  - Path: actions.submit.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de submissão.\n  - Path: actions.submit.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+s\") para o botão de submissão.\n  - Path: actions.cancel.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de cancelar.\n  - Path: actions.cancel.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de cancelar.\n  - Path: actions.cancel.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de cancelar.\n  - Path: actions.cancel.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de cancelar.\n  - Path: actions.cancel.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de cancelar.\n  - Path: actions.cancel.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de cancelar.\n  - Path: actions.cancel.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de cancelar.\n  - Path: actions.cancel.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de cancelar.\n  - Path: actions.cancel.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de cancelar.\n  - Path: actions.cancel.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de cancelar.\n  - Path: actions.cancel.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de cancelar.\n  - Path: actions.cancel.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.cancel.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de cancelar.\n  - Path: actions.cancel.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de cancelar.\n  - Path: actions.cancel.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"esc\") para o botão de cancelar.\n  - Path: actions.reset.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de reset.\n  - Path: actions.reset.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de reset.\n  - Path: actions.reset.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de reset.\n  - Path: actions.reset.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de reset.\n  - Path: actions.reset.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de reset.\n  - Path: actions.reset.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de reset.\n  - Path: actions.reset.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de reset.\n  - Path: actions.reset.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de reset.\n  - Path: actions.reset.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de reset.\n  - Path: actions.reset.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de reset.\n  - Path: actions.reset.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de reset.\n  - Path: actions.reset.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.reset.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de reset.\n  - Path: actions.reset.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de reset.\n  - Path: actions.reset.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+shift+r\") para o botão de reset.\n  - Path: actions.custom\n    Category: actions\n    Kind: array\n    Description: Lista de botões de ação customizados.\n  - Path: actions.custom[]\n    Category: actions\n    Kind: object\n    Description: Configuração de um botão de ação customizado.\n  - Path: actions.custom[].id\n    Category: actions\n    Kind: string\n    Description: ID da ação customizada.\n  - Path: actions.custom[].visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade da ação customizada.\n  - Path: actions.custom[].label\n    Category: actions\n    Kind: string\n    Description: Rótulo da ação customizada.\n  - Path: actions.custom[].icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para a ação customizada.\n  - Path: actions.custom[].color\n    Category: actions\n    Kind: enum\n    Description: Cor da ação customizada.\n  - Path: actions.custom[].variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual da ação customizada.\n  - Path: actions.custom[].size\n    Category: actions\n    Kind: enum\n    Description: Tamanho da ação customizada.\n  - Path: actions.custom[].className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada à ação customizada.\n  - Path: actions.custom[].style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados à ação customizada.\n  - Path: actions.custom[].disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita a ação customizada.\n  - Path: actions.custom[].type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão da ação customizada.\n  - Path: actions.custom[].action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.custom[].tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido na ação customizada.\n  - Path: actions.custom[].loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento na ação customizada.\n  - Path: actions.custom[].shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado para a ação customizada.\n  - Path: actions.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento horizontal da barra de ações.\n  - Path: actions.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões dentro da barra de ações (horizontal/vertical).\n  - Path: actions.spacing\n    Category: layout\n    Kind: enum\n    Description: Espaçamento entre os botões na barra de ações.\n  - Path: actions.sticky\n    Category: layout\n    Kind: boolean\n    Description: Define se a barra de ações deve permanecer visível ao rolar a página.\n  - Path: actions.divider\n    Category: layout\n    Kind: boolean\n    Description: Exibe um divisor superior acima da barra de ações.\n  - Path: actions.placement\n    Category: layout\n    Kind: enum\n    Description: Localização estrutural da barra de ações no layout.\n  - Path: actions.mobile.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento da barra de ações em dispositivos móveis.\n  - Path: actions.mobile.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões em dispositivos móveis.\n  - Path: actions.mobile.collapseToMenu\n    Category: behavior\n    Kind: boolean\n    Description: Em mobile, agrupa ações em um menu (se houver muitas).\n  - Path: actions.containerClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da barra de ações.\n  - Path: actions.containerStyles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da barra de ações.\n  - Path: actions.showSaveButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de submit.\n  - Path: actions.submitButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de submit.\n  - Path: actions.showCancelButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de cancel.\n  - Path: actions.cancelButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de cancel.\n  - Path: actions.showResetButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de reset.\n  - Path: actions.resetButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de reset.\n  - Path: behavior.confirmOnUnsavedChanges\n    Category: behavior\n    Kind: boolean\n    Description: Exibe um alerta se o usuário tentar sair com mudanças não salvas.\n  - Path: behavior.trackHistory\n    Category: behavior\n    Kind: boolean\n    Description: Habilita rastreamento de histórico para desfazer/refazer (se suportado).\n  - Path: behavior.focusFirstError\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, foca automaticamente no primeiro campo com erro.\n  - Path: behavior.scrollToErrors\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, rola a página para exibir o primeiro erro.\n  - Path: behavior.clearAfterSave\n    Category: behavior\n    Kind: boolean\n    Description: Limpa o formulário após uma submissão bem-sucedida.\n  - Path: behavior.redirectAfterSave\n    Category: behavior\n    Kind: string\n    Description: URL para redirecionar após uma submissão bem-sucedida.\n  - Path: behavior.reactiveValidation\n    Category: validation\n    Kind: boolean\n    Description: Ativa validação reativa (em tempo real) em `valueChanges`.\n  - Path: behavior.reactiveValidationDebounceMs\n    Category: validation\n    Kind: number\n    Description: Debounce (em ms) para a validação reativa.\n  - Path: api.saveEndpoint\n    Category: api\n    Kind: string\n    Description: URL para onde os dados do formulário serão enviados (POST/PUT/PATCH).\n  - Path: api.loadEndpoint\n    Category: api\n    Kind: string\n    Description: URL para buscar dados para popular o formulário (GET).\n  - Path: api.saveMethod\n    Category: api\n    Kind: enum\n    Description: Método HTTP para a requisição de salvar.\n  - Path: api.timeout\n    Category: api\n    Kind: number\n    Description: Tempo limite (em ms) para as requisições API.\n  - Path: api.headers\n    Category: api\n    Kind: object\n    Description: Cabeçalhos HTTP personalizados para as requisições API.\n  - Path: api.idField\n    Category: api\n    Kind: string\n    Description: Nome do campo que representa o ID do registro no payload (para PUT/PATCH).\n  - Path: api.beforeSave\n    Category: hooks\n    Kind: expression\n    Description: Hook para pré-processamento de dados antes de enviar para a API.\n  - Path: api.afterLoad\n    Category: hooks\n    Kind: expression\n    Description: Hook para pós-processamento de dados após carregar da API.\n  - Path: messages.updateRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após atualização de registro.\n  - Path: messages.createRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após criação de registro.\n  - Path: messages.updateRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após atualização de registro.\n  - Path: messages.createRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após criação de registro.\n  - Path: messages.confirmations.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de submeter o formulário.\n  - Path: messages.confirmations.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de cancelar.\n  - Path: messages.confirmations.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de resetar o formulário.\n  - Path: messages.confirmations.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para ações customizadas. Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId]\n    Category: messages\n    Kind: object\n    Description: Mensagens da ação customizada (success/error/confirmation). Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId].success\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso para a ação customizada.\n  - Path: messages.customActions.[actionId].error\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro para a ação customizada.\n  - Path: messages.customActions.[actionId].confirmation\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para a ação customizada.\n  - Path: messages.loading.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o envio do formulário.\n  - Path: messages.loading.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o cancelamento.\n  - Path: messages.loading.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o reset do formulário.\n  - Path: messages.loading.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante a execução de uma ação customizada. Substitua `[actionId]` pelo ID da ação.\n  - Path: formRules[].id\n    Category: rules\n    Kind: string\n    Description: ID único da regra de layout.\n  - Path: formRules[].name\n    Category: rules\n    Kind: string\n    Description: Nome amigável da regra de layout.\n  - Path: formRules[].description\n    Category: rules\n    Kind: string\n    Description: Descrição da regra de layout para documentação.\n  - Path: formRules[].metadata.origin\n    Category: rules\n    Kind: enum\n    Description: Origem da regra sugerida pela IA.\n  - Path: formRules[].metadata.reviewStatus\n    Category: rules\n    Kind: enum\n    Description: Status de revisão humana da regra sugerida pela IA.\n  - Path: formRules[].targetType\n    Category: rules\n    Kind: enum\n    Description: Tipo do elemento alvo da regra (campo, seção, ação, linha, coluna ou bloco visual).\n  - Path: formRules[].context\n    Category: rules\n    Kind: enum\n    Description: Contexto legado da regra (quando properties não forem informadas).\n  - Path: formRules[].targets\n    Category: rules\n    Kind: array\n    Description: Lista de IDs dos elementos alvo da regra. O tipo do ID depende de `targetType`.\n  - Path: formRules[].targets[]\n    Category: rules\n    Kind: string\n    Description: ID do alvo da regra.\n  - Path: formRules[].targetFields\n    Category: rules\n    Kind: array\n    Description: Alias legado para alvos de campo.\n  - Path: formRules[].targetFields[]\n    Category: rules\n    Kind: string\n    Description: ID do campo alvo (alias legado).\n  - Path: formRules[].effect.condition\n    Category: rules\n    Kind: expression\n    Description: Condicao canonica da regra, expressa em Json Logic.\n  - Path: formCommandRules\n    Category: rules\n    Kind: array\n    Description: Regras condicionais de comando avaliadas depois que formRules estabilizam valores calculados.\n  - Path: formCommandRules[].condition\n    Category: rules\n    Kind: expression\n    Description: Condicao Json Logic avaliada sobre formData estabilizado, incluindo field values calculados.\n  - Path: formCommandRules[].effects[].kind\n    Category: rules\n    Kind: enum\n    Description: Tipo do efeito de comando. O primeiro corte suporta apenas global-action.\n  - Path: formCommandRules[].effects[].globalAction\n    Category: rules\n    Kind: object\n    Description: GlobalActionRef estruturado executado por GlobalActionService.executeRef quando a regra entra na condicao.\n  - Path: formCommandRules[].policy\n    Category: rules\n    Kind: object\n    Description: Politica operacional do comando: trigger, distinct, distinctBy, debounceMs, errorPolicy e runOnInitialEvaluation.\n  - Path: formRulesState\n    Category: rules\n    Kind: object\n    Description: Estado interno do builder de regras (metadados visuais).\n  - Path: hooks\n    Category: hooks\n    Kind: object\n    Description: Declarações de hooks por estágio do ciclo de vida do formulário.\n  - Path: hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeInit.\n  - Path: hooks.beforeInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterInit.\n  - Path: hooks.afterInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeValidate.\n  - Path: hooks.beforeValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterValidate.\n  - Path: hooks.afterValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeSubmit.\n  - Path: hooks.beforeSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterSubmit.\n  - Path: hooks.afterSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para onError.\n  - Path: hooks.onError[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.onError[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.onError[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.onError[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hints.dataModes.create\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de criação de dados.\n  - Path: hints.dataModes.edit\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de edição de dados.\n  - Path: hints.dataModes.view\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visualização de dados.\n  - Path: hints.uiModes.presentation\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de apresentação da UI.\n  - Path: hints.uiModes.readonly\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de somente leitura da UI.\n  - Path: hints.uiModes.disabled\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo desabilitado da UI.\n  - Path: hints.uiModes.visible\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visibilidade da UI.\n  - Path: fieldMetadata[].id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: fieldMetadata[].version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: fieldMetadata[].context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: fieldMetadata[].createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: fieldMetadata[].updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: fieldMetadata[].tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: fieldMetadata[].cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: fieldMetadata[].style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: fieldMetadata[].dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: fieldMetadata[].name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: fieldMetadata[].label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: fieldMetadata[].placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: fieldMetadata[].hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: fieldMetadata[].tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: fieldMetadata[].description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: fieldMetadata[].selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: fieldMetadata[].variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: fieldMetadata[].density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: fieldMetadata[].links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: fieldMetadata[].group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: fieldMetadata[].order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: fieldMetadata[].width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: fieldMetadata[].isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: fieldMetadata[].controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: fieldMetadata[].dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: fieldMetadata[].source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: fieldMetadata[].materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: fieldMetadata[].materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: fieldMetadata[].materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: fieldMetadata[].materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: fieldMetadata[].materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: fieldMetadata[].materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: fieldMetadata[].materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: fieldMetadata[].prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: fieldMetadata[].suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: fieldMetadata[].iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: fieldMetadata[].iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: fieldMetadata[].mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: fieldMetadata[].format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: fieldMetadata[].validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: fieldMetadata[].validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: fieldMetadata[].required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: fieldMetadata[].validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: fieldMetadata[].validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: fieldMetadata[].validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: fieldMetadata[].validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: fieldMetadata[].validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: fieldMetadata[].validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: fieldMetadata[].validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: fieldMetadata[].validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: fieldMetadata[].validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: fieldMetadata[].validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: fieldMetadata[].validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: fieldMetadata[].validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: fieldMetadata[].validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: fieldMetadata[].validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: fieldMetadata[].validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: fieldMetadata[].validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: fieldMetadata[].validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: fieldMetadata[].validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: fieldMetadata[].validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: fieldMetadata[].validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: fieldMetadata[].validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: fieldMetadata[].validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: fieldMetadata[].validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: fieldMetadata[].validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: fieldMetadata[].validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: fieldMetadata[].validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: fieldMetadata[].validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: fieldMetadata[].validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: fieldMetadata[].validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: fieldMetadata[].validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: fieldMetadata[].validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: fieldMetadata[].validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: fieldMetadata[].validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: fieldMetadata[].validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: fieldMetadata[].validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: fieldMetadata[].validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: fieldMetadata[].debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: fieldMetadata[].options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: fieldMetadata[].endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: fieldMetadata[].valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: fieldMetadata[].displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: fieldMetadata[].filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: fieldMetadata[].queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: fieldMetadata[].cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: fieldMetadata[].hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: fieldMetadata[].visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: fieldMetadata[].formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: fieldMetadata[].tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: fieldMetadata[].filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: fieldMetadata[].dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: fieldMetadata[].conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: fieldMetadata[].conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: fieldMetadata[].dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: fieldMetadata[].dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: fieldMetadata[].dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: fieldMetadata[].dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: fieldMetadata[].resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: fieldMetadata[].enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: fieldMetadata[].dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: fieldMetadata[].suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\nComponent Capabilities:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\nCapability Notes:\n  - Este catalogo descreve inputs e outputs do componente.\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.\n",
+          "content": "Schema Capabilities:\n  - Path: metadata.version\n    Category: metadata\n    Kind: string\n    Description: Versão da configuração do formulário para controle de migração.\n  - Path: metadata.source\n    Category: metadata\n    Kind: enum\n    Description: Origem da configuração do formulário.\n  - Path: metadata.lastUpdated\n    Category: metadata\n    Kind: string\n    Description: Timestamp da última atualização da configuração (ISO-8601).\n  - Path: metadata.schemaId\n    Category: metadata\n    Kind: string\n    Description: ID do schema de origem para reconciliação no servidor.\n  - Path: metadata.schemaContext\n    Category: metadata\n    Kind: object\n    Description: Contexto do schema usado para compor o formulário.\n  - Path: metadata.schemaContext.path\n    Category: metadata\n    Kind: string\n    Description: Path do schema de origem.\n  - Path: metadata.schemaContext.operation\n    Category: metadata\n    Kind: string\n    Description: Operação do schema (ex.: \"get\", \"post\").\n  - Path: metadata.schemaContext.schemaType\n    Category: metadata\n    Kind: enum\n    Description: Tipo do schema (response/request).\n  - Path: metadata.schemaContext.internal\n    Category: metadata\n    Kind: boolean\n    Description: Indica se o schema é interno.\n  - Path: metadata.schemaContext.tenant\n    Category: metadata\n    Kind: string\n    Description: Tenant do schema (se aplicável).\n  - Path: metadata.schemaContext.locale\n    Category: metadata\n    Kind: string\n    Description: Locale do schema (se aplicável).\n  - Path: metadata.serverHash\n    Category: metadata\n    Kind: string\n    Description: Hash dos dados do servidor para detecção de mudanças.\n  - Path: metadata.customizations\n    Category: metadata\n    Kind: array\n    Description: Log de customizações manuais aplicadas ao formulário.\n  - Path: fieldMetadata\n    Category: fields\n    Kind: array\n    Description: Array de metadados dos campos. Usado para referenciar a configuração de campos.\n  - Path: fieldMetadata[]\n    Category: fields\n    Kind: object\n    Description: Item de metadados do campo (FieldMetadata).\n  - Path: editorialContext\n    Category: editorial\n    Kind: object\n    Description: Contexto editorial compartilhado entre os blocos hospedados antes/depois do formulario.\n  - Path: editorialContext.[token]\n    Category: editorial\n    Kind: string\n    Description: Valor simples exposto no contexto editorial.\n  - Path: formBlocksBefore\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado antes do formulario.\n  - Path: formBlocksBefore.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content.\n  - Path: formBlocksBefore.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content editorial.\n  - Path: formBlocksBefore.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes do formulario.\n  - Path: formBlocksBefore.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes do formulario.\n  - Path: formBlocksBefore.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content hospedado antes do formulario.\n  - Path: formBlocksBeforeActions\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois das seções e antes da área principal de ações.\n  - Path: formBlocksBeforeActions.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes da área principal de ações.\n  - Path: formBlocksBeforeActions.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes da área principal de ações.\n  - Path: formBlocksBeforeActions.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content antes das ações.\n  - Path: formBlocksAfter\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois do formulario inteiro, incluindo a área principal de ações.\n  - Path: formBlocksAfter.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content de fechamento.\n  - Path: formBlocksAfter.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content de fechamento.\n  - Path: formBlocksAfter.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados depois do formulario.\n  - Path: formBlocksAfter.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado depois do formulario.\n  - Path: formBlocksAfter.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content de fechamento.\n  - Path: sections[].id\n    Category: layout\n    Kind: string\n    Description: ID único da seção.\n  - Path: sections[].title\n    Category: layout\n    Kind: string\n    Description: Título exibido para cada seção do formulário.\n  - Path: sections[].description\n    Category: layout\n    Kind: string\n    Description: Descrição auxiliar exibida abaixo do título da seção.\n  - Path: sections[].icon\n    Category: layout\n    Kind: string\n    Description: Nome do ícone (Material Icons) para o cabeçalho da seção.\n  - Path: sections[].sectionHeader\n    Category: layout\n    Kind: object\n    Description: Configuração rica do header visual da seção, com suporte a avatar por imagem, iniciais ou modo automático.\n  - Path: sections[].sectionHeader.mode\n    Category: layout\n    Kind: enum\n    Description: Estratégia visual do header da seção.\n  - Path: sections[].sectionHeader.sourceField\n    Category: layout\n    Kind: string\n    Description: Campo do formulário usado como origem da imagem do avatar.\n  - Path: sections[].sectionHeader.initialsSourceField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado para derivar iniciais do avatar.\n  - Path: sections[].sectionHeader.altField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado como texto acessivel do avatar e como fallback textual para iniciais quando initialsSourceField nao estiver definido.\n  - Path: sections[].sectionHeader.fallbackIcon\n    Category: layout\n    Kind: string\n    Description: Ícone opcional usado quando o avatar dinâmico estiver vazio ou inválido.\n  - Path: sections[].sectionHeader.emptyState\n    Category: layout\n    Kind: enum\n    Description: Comportamento do header quando os campos de origem ainda não possuem valor.\n  - Path: sections[].sectionHeader.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semântico do avatar da seção, materializado pelo runtime via tokens.\n  - Path: sections[].sectionHeader.initialsMaxLength\n    Category: layout\n    Kind: number\n    Description: Máximo de letras exibidas no avatar textual.\n  - Path: sections[].collapsible\n    Category: layout\n    Kind: boolean\n    Description: Define se a seção pode ser colapsada/expandida pelo usuário.\n  - Path: sections[].collapsed\n    Category: layout\n    Kind: boolean\n    Description: Estado inicial da seção (colapsada/expandida) quando `collapsible` é true.\n  - Path: sections[].gapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após a seção.\n  - Path: sections[].titleGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo do título da seção.\n  - Path: sections[].descriptionGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo da descrição da seção.\n  - Path: sections[].appearance\n    Category: appearance\n    Kind: enum\n    Description: Preset visual do container/cabeçalho da seção.\n  - Path: sections[].stepLabel\n    Category: content\n    Kind: string\n    Description: Rótulo curto do passo exibido antes do título da seção.\n  - Path: sections[].titleStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para o título da seção.\n  - Path: sections[].descriptionStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para a descrição da seção.\n  - Path: sections[].titleColor\n    Category: appearance\n    Kind: string\n    Description: Cor do título da seção (CSS color ou token).\n  - Path: sections[].descriptionColor\n    Category: appearance\n    Kind: string\n    Description: Cor da descrição da seção (CSS color ou token).\n  - Path: sections[].headerAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento horizontal do conteúdo do cabeçalho da seção.\n  - Path: sections[].headerTooltip\n    Category: layout\n    Kind: string\n    Description: Texto de tooltip para o cabeçalho da seção.\n  - Path: sections[].headerActions\n    Category: layout\n    Kind: array\n    Description: Lista de ações iconográficas renderizadas no canto direito do cabeçalho da seção.\n  - Path: sections[].headerActions[].id\n    Category: layout\n    Kind: string\n    Description: ID estável da ação de cabeçalho da seção.\n  - Path: sections[].headerActions[].label\n    Category: layout\n    Kind: string\n    Description: Label acessível usada em tooltip e aria-label da ação.\n  - Path: sections[].headerActions[].icon\n    Category: layout\n    Kind: string\n    Description: Ícone renderizado na ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].action\n    Category: layout\n    Kind: string\n    Description: Nome opcional da ação emitida no customAction; se ausente, o runtime usa o ID.\n  - Path: sections[].headerActions[].tooltip\n    Category: layout\n    Kind: string\n    Description: Tooltip opcional da ação; se ausente, o runtime usa a label.\n  - Path: sections[].headerActions[].color\n    Category: appearance\n    Kind: enum\n    Description: Tom visual da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].visible\n    Category: layout\n    Kind: boolean\n    Description: Controla a visibilidade da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].disabled\n    Category: layout\n    Kind: boolean\n    Description: Controla o estado desabilitado da ação do cabeçalho da seção.\n  - Path: sections[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da seção.\n  - Path: sections[].styles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da seção.\n  - Path: sections[].rows[].id\n    Category: layout\n    Kind: string\n    Description: ID único da linha dentro de uma seção.\n  - Path: sections[].rows[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da linha (usado em editores e labels).\n  - Path: sections[].rows[].gap\n    Category: layout\n    Kind: number\n    Description: Espaçamento horizontal (em px) entre colunas nesta linha.\n  - Path: sections[].rows[].rowGap\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após esta linha.\n  - Path: sections[].rows[].columns[].id\n    Category: layout\n    Kind: string\n    Description: ID único da coluna dentro de uma linha.\n  - Path: sections[].rows[].columns[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da coluna (usado em editores e labels).\n  - Path: sections[].rows[].columns[].testId\n    Category: layout\n    Kind: string\n    Description: Atributo data-testid aplicado ao container da coluna.\n  - Path: sections[].rows[].columns[].fields\n    Category: layout\n    Kind: array\n    Description: Projeção legada/derivada dos itens kind:\"field\" dentro da coluna.\n  - Path: sections[].rows[].columns[].fields[]\n    Category: layout\n    Kind: string\n    Description: Nome do campo dentro da projeção legada/derivada da coluna.\n  - Path: sections[].rows[].columns[].items\n    Category: layout\n    Kind: array\n    Description: Lista canônica ordenada de itens da coluna: campos e blocos visuais.\n  - Path: sections[].rows[].columns[].items[].kind\n    Category: layout\n    Kind: enum\n    Description: Tipo do item de layout da coluna.\n  - Path: sections[].rows[].columns[].items[].id\n    Category: layout\n    Kind: string\n    Description: ID estável do item de layout dentro do formulário.\n  - Path: sections[].rows[].columns[].items[].fieldName\n    Category: layout\n    Kind: string\n    Description: Nome do campo quando kind é \"field\".\n  - Path: sections[].rows[].columns[].items[].document\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument do bloco visual quando kind é \"richContent\".\n  - Path: sections[].rows[].columns[].items[].layout\n    Category: editorial\n    Kind: enum\n    Description: Modo de renderização do bloco visual richContent dentro da coluna.\n  - Path: sections[].rows[].columns[].items[].rootClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS opcional aplicada ao bloco visual richContent.\n  - Path: sections[].rows[].columns[].span.xs\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.sm\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.md\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.lg\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.xl\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xs\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.sm\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.md\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.lg\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xl\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].order.xs\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].order.sm\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].order.md\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].order.lg\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].order.xl\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].hidden.xs\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].hidden.sm\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].hidden.md\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].hidden.lg\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].hidden.xl\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].align\n    Category: layout\n    Kind: enum\n    Description: Alinhamento vertical do conteúdo da coluna.\n  - Path: sections[].rows[].columns[].padding\n    Category: layout\n    Kind: number\n    Description: Padding (em px) interno da coluna.\n  - Path: sections[].rows[].columns[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada à coluna.\n  - Path: actions.submit.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de submissão.\n  - Path: actions.submit.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de submissão.\n  - Path: actions.submit.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de submissão.\n  - Path: actions.submit.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de submissão.\n  - Path: actions.submit.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de submissão.\n  - Path: actions.submit.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de submissão.\n  - Path: actions.submit.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de submissão.\n  - Path: actions.submit.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de submissão.\n  - Path: actions.submit.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de submissão.\n  - Path: actions.submit.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de submissão.\n  - Path: actions.submit.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de submissão.\n  - Path: actions.submit.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.submit.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de submissão.\n  - Path: actions.submit.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de submissão.\n  - Path: actions.submit.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+s\") para o botão de submissão.\n  - Path: actions.cancel.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de cancelar.\n  - Path: actions.cancel.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de cancelar.\n  - Path: actions.cancel.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de cancelar.\n  - Path: actions.cancel.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de cancelar.\n  - Path: actions.cancel.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de cancelar.\n  - Path: actions.cancel.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de cancelar.\n  - Path: actions.cancel.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de cancelar.\n  - Path: actions.cancel.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de cancelar.\n  - Path: actions.cancel.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de cancelar.\n  - Path: actions.cancel.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de cancelar.\n  - Path: actions.cancel.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de cancelar.\n  - Path: actions.cancel.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.cancel.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de cancelar.\n  - Path: actions.cancel.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de cancelar.\n  - Path: actions.cancel.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"esc\") para o botão de cancelar.\n  - Path: actions.reset.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de reset.\n  - Path: actions.reset.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de reset.\n  - Path: actions.reset.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de reset.\n  - Path: actions.reset.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de reset.\n  - Path: actions.reset.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de reset.\n  - Path: actions.reset.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de reset.\n  - Path: actions.reset.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de reset.\n  - Path: actions.reset.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de reset.\n  - Path: actions.reset.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de reset.\n  - Path: actions.reset.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de reset.\n  - Path: actions.reset.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de reset.\n  - Path: actions.reset.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.reset.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de reset.\n  - Path: actions.reset.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de reset.\n  - Path: actions.reset.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+shift+r\") para o botão de reset.\n  - Path: actions.custom\n    Category: actions\n    Kind: array\n    Description: Lista de botões de ação customizados.\n  - Path: actions.custom[]\n    Category: actions\n    Kind: object\n    Description: Configuração de um botão de ação customizado.\n  - Path: actions.custom[].id\n    Category: actions\n    Kind: string\n    Description: ID da ação customizada.\n  - Path: actions.custom[].visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade da ação customizada.\n  - Path: actions.custom[].label\n    Category: actions\n    Kind: string\n    Description: Rótulo da ação customizada.\n  - Path: actions.custom[].icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para a ação customizada.\n  - Path: actions.custom[].color\n    Category: actions\n    Kind: enum\n    Description: Cor da ação customizada.\n  - Path: actions.custom[].variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual da ação customizada.\n  - Path: actions.custom[].size\n    Category: actions\n    Kind: enum\n    Description: Tamanho da ação customizada.\n  - Path: actions.custom[].className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada à ação customizada.\n  - Path: actions.custom[].style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados à ação customizada.\n  - Path: actions.custom[].disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita a ação customizada.\n  - Path: actions.custom[].type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão da ação customizada.\n  - Path: actions.custom[].action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.custom[].tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido na ação customizada.\n  - Path: actions.custom[].loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento na ação customizada.\n  - Path: actions.custom[].shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado para a ação customizada.\n  - Path: actions.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento horizontal da barra de ações.\n  - Path: actions.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões dentro da barra de ações (horizontal/vertical).\n  - Path: actions.spacing\n    Category: layout\n    Kind: enum\n    Description: Espaçamento entre os botões na barra de ações.\n  - Path: actions.sticky\n    Category: layout\n    Kind: boolean\n    Description: Define se a barra de ações deve permanecer visível ao rolar a página.\n  - Path: actions.divider\n    Category: layout\n    Kind: boolean\n    Description: Exibe um divisor superior acima da barra de ações.\n  - Path: actions.placement\n    Category: layout\n    Kind: enum\n    Description: Localização estrutural da barra de ações no layout.\n  - Path: actions.mobile.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento da barra de ações em dispositivos móveis.\n  - Path: actions.mobile.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões em dispositivos móveis.\n  - Path: actions.mobile.collapseToMenu\n    Category: behavior\n    Kind: boolean\n    Description: Em mobile, agrupa ações em um menu (se houver muitas).\n  - Path: actions.containerClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da barra de ações.\n  - Path: actions.containerStyles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da barra de ações.\n  - Path: actions.showSaveButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de submit.\n  - Path: actions.submitButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de submit.\n  - Path: actions.showCancelButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de cancel.\n  - Path: actions.cancelButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de cancel.\n  - Path: actions.showResetButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de reset.\n  - Path: actions.resetButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de reset.\n  - Path: behavior.confirmOnUnsavedChanges\n    Category: behavior\n    Kind: boolean\n    Description: Exibe um alerta se o usuário tentar sair com mudanças não salvas.\n  - Path: behavior.trackHistory\n    Category: behavior\n    Kind: boolean\n    Description: Habilita rastreamento de histórico para desfazer/refazer (se suportado).\n  - Path: behavior.focusFirstError\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, foca automaticamente no primeiro campo com erro.\n  - Path: behavior.scrollToErrors\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, rola a página para exibir o primeiro erro.\n  - Path: behavior.clearAfterSave\n    Category: behavior\n    Kind: boolean\n    Description: Limpa o formulário após uma submissão bem-sucedida.\n  - Path: behavior.redirectAfterSave\n    Category: behavior\n    Kind: string\n    Description: URL para redirecionar após uma submissão bem-sucedida.\n  - Path: behavior.reactiveValidation\n    Category: validation\n    Kind: boolean\n    Description: Ativa validação reativa (em tempo real) em `valueChanges`.\n  - Path: behavior.reactiveValidationDebounceMs\n    Category: validation\n    Kind: number\n    Description: Debounce (em ms) para a validação reativa.\n  - Path: api.saveEndpoint\n    Category: api\n    Kind: string\n    Description: URL para onde os dados do formulário serão enviados (POST/PUT/PATCH).\n  - Path: api.loadEndpoint\n    Category: api\n    Kind: string\n    Description: URL para buscar dados para popular o formulário (GET).\n  - Path: api.saveMethod\n    Category: api\n    Kind: enum\n    Description: Método HTTP para a requisição de salvar.\n  - Path: api.timeout\n    Category: api\n    Kind: number\n    Description: Tempo limite (em ms) para as requisições API.\n  - Path: api.headers\n    Category: api\n    Kind: object\n    Description: Cabeçalhos HTTP personalizados para as requisições API.\n  - Path: api.idField\n    Category: api\n    Kind: string\n    Description: Nome do campo que representa o ID do registro no payload (para PUT/PATCH).\n  - Path: api.beforeSave\n    Category: hooks\n    Kind: expression\n    Description: Hook para pré-processamento de dados antes de enviar para a API.\n  - Path: api.afterLoad\n    Category: hooks\n    Kind: expression\n    Description: Hook para pós-processamento de dados após carregar da API.\n  - Path: messages.updateRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após atualização de registro.\n  - Path: messages.createRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após criação de registro.\n  - Path: messages.updateRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após atualização de registro.\n  - Path: messages.createRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após criação de registro.\n  - Path: messages.confirmations.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de submeter o formulário.\n  - Path: messages.confirmations.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de cancelar.\n  - Path: messages.confirmations.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de resetar o formulário.\n  - Path: messages.confirmations.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para ações customizadas. Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId]\n    Category: messages\n    Kind: object\n    Description: Mensagens da ação customizada (success/error/confirmation). Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId].success\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso para a ação customizada.\n  - Path: messages.customActions.[actionId].error\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro para a ação customizada.\n  - Path: messages.customActions.[actionId].confirmation\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para a ação customizada.\n  - Path: messages.loading.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o envio do formulário.\n  - Path: messages.loading.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o cancelamento.\n  - Path: messages.loading.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o reset do formulário.\n  - Path: messages.loading.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante a execução de uma ação customizada. Substitua `[actionId]` pelo ID da ação.\n  - Path: formRules[].id\n    Category: rules\n    Kind: string\n    Description: ID único da regra de layout.\n  - Path: formRules[].name\n    Category: rules\n    Kind: string\n    Description: Nome amigável da regra de layout.\n  - Path: formRules[].description\n    Category: rules\n    Kind: string\n    Description: Descrição da regra de layout para documentação.\n  - Path: formRules[].metadata.origin\n    Category: rules\n    Kind: enum\n    Description: Origem da regra sugerida pela IA.\n  - Path: formRules[].metadata.reviewStatus\n    Category: rules\n    Kind: enum\n    Description: Status de revisão humana da regra sugerida pela IA.\n  - Path: formRules[].targetType\n    Category: rules\n    Kind: enum\n    Description: Tipo do elemento alvo da regra (campo, seção, ação, linha, coluna ou bloco visual).\n  - Path: formRules[].context\n    Category: rules\n    Kind: enum\n    Description: Contexto legado da regra (quando properties não forem informadas).\n  - Path: formRules[].targets\n    Category: rules\n    Kind: array\n    Description: Lista de IDs dos elementos alvo da regra. O tipo do ID depende de `targetType`.\n  - Path: formRules[].targets[]\n    Category: rules\n    Kind: string\n    Description: ID do alvo da regra.\n  - Path: formRules[].targetFields\n    Category: rules\n    Kind: array\n    Description: Alias legado para alvos de campo.\n  - Path: formRules[].targetFields[]\n    Category: rules\n    Kind: string\n    Description: ID do campo alvo (alias legado).\n  - Path: formRules[].effect.condition\n    Category: rules\n    Kind: expression\n    Description: Condicao canonica da regra, expressa em Json Logic.\n  - Path: formCommandRules\n    Category: rules\n    Kind: array\n    Description: Regras condicionais de comando avaliadas depois que formRules estabilizam valores calculados.\n  - Path: formCommandRules[].condition\n    Category: rules\n    Kind: expression\n    Description: Condicao Json Logic avaliada sobre formData estabilizado, incluindo field values calculados.\n  - Path: formCommandRules[].effects[].kind\n    Category: rules\n    Kind: enum\n    Description: Tipo do efeito de comando. O primeiro corte suporta apenas global-action.\n  - Path: formCommandRules[].effects[].globalAction\n    Category: rules\n    Kind: object\n    Description: GlobalActionRef estruturado executado por GlobalActionService.executeRef quando a regra entra na condicao.\n  - Path: formCommandRules[].policy\n    Category: rules\n    Kind: object\n    Description: Politica operacional do comando: trigger, distinct, distinctBy, debounceMs, errorPolicy e runOnInitialEvaluation.\n  - Path: formRulesState\n    Category: rules\n    Kind: object\n    Description: Estado interno do builder de regras (metadados visuais).\n  - Path: hooks\n    Category: hooks\n    Kind: object\n    Description: Declarações de hooks por estágio do ciclo de vida do formulário.\n  - Path: hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeInit.\n  - Path: hooks.beforeInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterInit.\n  - Path: hooks.afterInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeValidate.\n  - Path: hooks.beforeValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterValidate.\n  - Path: hooks.afterValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeSubmit.\n  - Path: hooks.beforeSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterSubmit.\n  - Path: hooks.afterSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para onError.\n  - Path: hooks.onError[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.onError[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.onError[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.onError[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hints.dataModes.create\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de criação de dados.\n  - Path: hints.dataModes.edit\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de edição de dados.\n  - Path: hints.dataModes.view\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visualização de dados.\n  - Path: hints.uiModes.presentation\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de apresentação da UI.\n  - Path: hints.uiModes.readonly\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de somente leitura da UI.\n  - Path: hints.uiModes.disabled\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo desabilitado da UI.\n  - Path: hints.uiModes.visible\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visibilidade da UI.\n  - Path: fieldMetadata[].id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: fieldMetadata[].version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: fieldMetadata[].context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: fieldMetadata[].createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: fieldMetadata[].updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: fieldMetadata[].tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: fieldMetadata[].cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: fieldMetadata[].style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: fieldMetadata[].dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: fieldMetadata[].name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: fieldMetadata[].label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: fieldMetadata[].placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: fieldMetadata[].hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: fieldMetadata[].helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: fieldMetadata[].tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: fieldMetadata[].tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: fieldMetadata[].description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: fieldMetadata[].selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: fieldMetadata[].variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: fieldMetadata[].density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: fieldMetadata[].links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: fieldMetadata[].group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: fieldMetadata[].order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: fieldMetadata[].width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: fieldMetadata[].isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: fieldMetadata[].controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: fieldMetadata[].dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: fieldMetadata[].source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: fieldMetadata[].materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: fieldMetadata[].materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: fieldMetadata[].materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: fieldMetadata[].materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: fieldMetadata[].materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: fieldMetadata[].materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: fieldMetadata[].materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: fieldMetadata[].prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: fieldMetadata[].suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: fieldMetadata[].iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: fieldMetadata[].iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: fieldMetadata[].iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: fieldMetadata[].iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: fieldMetadata[].iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: fieldMetadata[].iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: fieldMetadata[].mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: fieldMetadata[].format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: fieldMetadata[].validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: fieldMetadata[].validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: fieldMetadata[].required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: fieldMetadata[].validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: fieldMetadata[].validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: fieldMetadata[].validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: fieldMetadata[].validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: fieldMetadata[].validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: fieldMetadata[].validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: fieldMetadata[].validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: fieldMetadata[].validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: fieldMetadata[].validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: fieldMetadata[].validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: fieldMetadata[].validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: fieldMetadata[].validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: fieldMetadata[].validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: fieldMetadata[].validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: fieldMetadata[].validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: fieldMetadata[].validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: fieldMetadata[].validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: fieldMetadata[].validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: fieldMetadata[].validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: fieldMetadata[].validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: fieldMetadata[].validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: fieldMetadata[].validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: fieldMetadata[].validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: fieldMetadata[].validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: fieldMetadata[].validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: fieldMetadata[].validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: fieldMetadata[].validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: fieldMetadata[].validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: fieldMetadata[].validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: fieldMetadata[].validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: fieldMetadata[].validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: fieldMetadata[].validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: fieldMetadata[].validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: fieldMetadata[].validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: fieldMetadata[].validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: fieldMetadata[].validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: fieldMetadata[].debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: fieldMetadata[].options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: fieldMetadata[].endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: fieldMetadata[].valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: fieldMetadata[].displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: fieldMetadata[].filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: fieldMetadata[].queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: fieldMetadata[].cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: fieldMetadata[].hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: fieldMetadata[].visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: fieldMetadata[].formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: fieldMetadata[].tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: fieldMetadata[].filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: fieldMetadata[].dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: fieldMetadata[].conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: fieldMetadata[].conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: fieldMetadata[].dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: fieldMetadata[].dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: fieldMetadata[].dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: fieldMetadata[].dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: fieldMetadata[].resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: fieldMetadata[].enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: fieldMetadata[].dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: fieldMetadata[].suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\nComponent Capabilities:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\nCapability Notes:\n  - Este catalogo descreve inputs e outputs do componente.\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "7e3d89b798ba67a90a0cedfe18e0b6ef0cef0c6eab71b1b0e28fc75ab68555af",
+          "contentHash": "3d7166fa9c54731044e538033ce4969a1fe9c4a5cef5bc7fcbf597dbc7c1a765",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -10168,6 +10228,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "fieldMetadata[].helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "fieldMetadata[].tooltip",
           "category": "identity",
@@ -10177,6 +10247,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "fieldMetadata[].tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "fieldMetadata[].description",
           "category": "identity",
@@ -10501,6 +10581,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "fieldMetadata[].iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "fieldMetadata[].iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "fieldMetadata[].mask",
           "category": "appearance",
@@ -13167,9 +13287,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: metadata.version\n    Category: metadata\n    Kind: string\n    Description: Versão da configuração do formulário para controle de migração.\n  - Path: metadata.source\n    Category: metadata\n    Kind: enum\n    Description: Origem da configuração do formulário.\n  - Path: metadata.lastUpdated\n    Category: metadata\n    Kind: string\n    Description: Timestamp da última atualização da configuração (ISO-8601).\n  - Path: metadata.schemaId\n    Category: metadata\n    Kind: string\n    Description: ID do schema de origem para reconciliação no servidor.\n  - Path: metadata.schemaContext\n    Category: metadata\n    Kind: object\n    Description: Contexto do schema usado para compor o formulário.\n  - Path: metadata.schemaContext.path\n    Category: metadata\n    Kind: string\n    Description: Path do schema de origem.\n  - Path: metadata.schemaContext.operation\n    Category: metadata\n    Kind: string\n    Description: Operação do schema (ex.: \"get\", \"post\").\n  - Path: metadata.schemaContext.schemaType\n    Category: metadata\n    Kind: enum\n    Description: Tipo do schema (response/request).\n  - Path: metadata.schemaContext.internal\n    Category: metadata\n    Kind: boolean\n    Description: Indica se o schema é interno.\n  - Path: metadata.schemaContext.tenant\n    Category: metadata\n    Kind: string\n    Description: Tenant do schema (se aplicável).\n  - Path: metadata.schemaContext.locale\n    Category: metadata\n    Kind: string\n    Description: Locale do schema (se aplicável).\n  - Path: metadata.serverHash\n    Category: metadata\n    Kind: string\n    Description: Hash dos dados do servidor para detecção de mudanças.\n  - Path: metadata.customizations\n    Category: metadata\n    Kind: array\n    Description: Log de customizações manuais aplicadas ao formulário.\n  - Path: fieldMetadata\n    Category: fields\n    Kind: array\n    Description: Array de metadados dos campos. Usado para referenciar a configuração de campos.\n  - Path: fieldMetadata[]\n    Category: fields\n    Kind: object\n    Description: Item de metadados do campo (FieldMetadata).\n  - Path: editorialContext\n    Category: editorial\n    Kind: object\n    Description: Contexto editorial compartilhado entre os blocos hospedados antes/depois do formulario.\n  - Path: editorialContext.[token]\n    Category: editorial\n    Kind: string\n    Description: Valor simples exposto no contexto editorial.\n  - Path: formBlocksBefore\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado antes do formulario.\n  - Path: formBlocksBefore.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content.\n  - Path: formBlocksBefore.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content editorial.\n  - Path: formBlocksBefore.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes do formulario.\n  - Path: formBlocksBefore.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes do formulario.\n  - Path: formBlocksBefore.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content hospedado antes do formulario.\n  - Path: formBlocksBeforeActions\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois das seções e antes da área principal de ações.\n  - Path: formBlocksBeforeActions.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes da área principal de ações.\n  - Path: formBlocksBeforeActions.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes da área principal de ações.\n  - Path: formBlocksBeforeActions.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content antes das ações.\n  - Path: formBlocksAfter\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois do formulario inteiro, incluindo a área principal de ações.\n  - Path: formBlocksAfter.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content de fechamento.\n  - Path: formBlocksAfter.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content de fechamento.\n  - Path: formBlocksAfter.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados depois do formulario.\n  - Path: formBlocksAfter.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado depois do formulario.\n  - Path: formBlocksAfter.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content de fechamento.\n  - Path: sections[].id\n    Category: layout\n    Kind: string\n    Description: ID único da seção.\n  - Path: sections[].title\n    Category: layout\n    Kind: string\n    Description: Título exibido para cada seção do formulário.\n  - Path: sections[].description\n    Category: layout\n    Kind: string\n    Description: Descrição auxiliar exibida abaixo do título da seção.\n  - Path: sections[].icon\n    Category: layout\n    Kind: string\n    Description: Nome do ícone (Material Icons) para o cabeçalho da seção.\n  - Path: sections[].sectionHeader\n    Category: layout\n    Kind: object\n    Description: Configuração rica do header visual da seção, com suporte a avatar por imagem, iniciais ou modo automático.\n  - Path: sections[].sectionHeader.mode\n    Category: layout\n    Kind: enum\n    Description: Estratégia visual do header da seção.\n  - Path: sections[].sectionHeader.sourceField\n    Category: layout\n    Kind: string\n    Description: Campo do formulário usado como origem da imagem do avatar.\n  - Path: sections[].sectionHeader.initialsSourceField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado para derivar iniciais do avatar.\n  - Path: sections[].sectionHeader.altField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado como texto acessivel do avatar e como fallback textual para iniciais quando initialsSourceField nao estiver definido.\n  - Path: sections[].sectionHeader.fallbackIcon\n    Category: layout\n    Kind: string\n    Description: Ícone opcional usado quando o avatar dinâmico estiver vazio ou inválido.\n  - Path: sections[].sectionHeader.emptyState\n    Category: layout\n    Kind: enum\n    Description: Comportamento do header quando os campos de origem ainda não possuem valor.\n  - Path: sections[].sectionHeader.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semântico do avatar da seção, materializado pelo runtime via tokens.\n  - Path: sections[].sectionHeader.initialsMaxLength\n    Category: layout\n    Kind: number\n    Description: Máximo de letras exibidas no avatar textual.\n  - Path: sections[].collapsible\n    Category: layout\n    Kind: boolean\n    Description: Define se a seção pode ser colapsada/expandida pelo usuário.\n  - Path: sections[].collapsed\n    Category: layout\n    Kind: boolean\n    Description: Estado inicial da seção (colapsada/expandida) quando `collapsible` é true.\n  - Path: sections[].gapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após a seção.\n  - Path: sections[].titleGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo do título da seção.\n  - Path: sections[].descriptionGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo da descrição da seção.\n  - Path: sections[].appearance\n    Category: appearance\n    Kind: enum\n    Description: Preset visual do container/cabeçalho da seção.\n  - Path: sections[].stepLabel\n    Category: content\n    Kind: string\n    Description: Rótulo curto do passo exibido antes do título da seção.\n  - Path: sections[].titleStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para o título da seção.\n  - Path: sections[].descriptionStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para a descrição da seção.\n  - Path: sections[].titleColor\n    Category: appearance\n    Kind: string\n    Description: Cor do título da seção (CSS color ou token).\n  - Path: sections[].descriptionColor\n    Category: appearance\n    Kind: string\n    Description: Cor da descrição da seção (CSS color ou token).\n  - Path: sections[].headerAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento horizontal do conteúdo do cabeçalho da seção.\n  - Path: sections[].headerTooltip\n    Category: layout\n    Kind: string\n    Description: Texto de tooltip para o cabeçalho da seção.\n  - Path: sections[].headerActions\n    Category: layout\n    Kind: array\n    Description: Lista de ações iconográficas renderizadas no canto direito do cabeçalho da seção.\n  - Path: sections[].headerActions[].id\n    Category: layout\n    Kind: string\n    Description: ID estável da ação de cabeçalho da seção.\n  - Path: sections[].headerActions[].label\n    Category: layout\n    Kind: string\n    Description: Label acessível usada em tooltip e aria-label da ação.\n  - Path: sections[].headerActions[].icon\n    Category: layout\n    Kind: string\n    Description: Ícone renderizado na ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].action\n    Category: layout\n    Kind: string\n    Description: Nome opcional da ação emitida no customAction; se ausente, o runtime usa o ID.\n  - Path: sections[].headerActions[].tooltip\n    Category: layout\n    Kind: string\n    Description: Tooltip opcional da ação; se ausente, o runtime usa a label.\n  - Path: sections[].headerActions[].color\n    Category: appearance\n    Kind: enum\n    Description: Tom visual da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].visible\n    Category: layout\n    Kind: boolean\n    Description: Controla a visibilidade da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].disabled\n    Category: layout\n    Kind: boolean\n    Description: Controla o estado desabilitado da ação do cabeçalho da seção.\n  - Path: sections[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da seção.\n  - Path: sections[].styles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da seção.\n  - Path: sections[].rows[].id\n    Category: layout\n    Kind: string\n    Description: ID único da linha dentro de uma seção.\n  - Path: sections[].rows[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da linha (usado em editores e labels).\n  - Path: sections[].rows[].gap\n    Category: layout\n    Kind: number\n    Description: Espaçamento horizontal (em px) entre colunas nesta linha.\n  - Path: sections[].rows[].rowGap\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após esta linha.\n  - Path: sections[].rows[].columns[].id\n    Category: layout\n    Kind: string\n    Description: ID único da coluna dentro de uma linha.\n  - Path: sections[].rows[].columns[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da coluna (usado em editores e labels).\n  - Path: sections[].rows[].columns[].testId\n    Category: layout\n    Kind: string\n    Description: Atributo data-testid aplicado ao container da coluna.\n  - Path: sections[].rows[].columns[].fields\n    Category: layout\n    Kind: array\n    Description: Projeção legada/derivada dos itens kind:\"field\" dentro da coluna.\n  - Path: sections[].rows[].columns[].fields[]\n    Category: layout\n    Kind: string\n    Description: Nome do campo dentro da projeção legada/derivada da coluna.\n  - Path: sections[].rows[].columns[].items\n    Category: layout\n    Kind: array\n    Description: Lista canônica ordenada de itens da coluna: campos e blocos visuais.\n  - Path: sections[].rows[].columns[].items[].kind\n    Category: layout\n    Kind: enum\n    Description: Tipo do item de layout da coluna.\n  - Path: sections[].rows[].columns[].items[].id\n    Category: layout\n    Kind: string\n    Description: ID estável do item de layout dentro do formulário.\n  - Path: sections[].rows[].columns[].items[].fieldName\n    Category: layout\n    Kind: string\n    Description: Nome do campo quando kind é \"field\".\n  - Path: sections[].rows[].columns[].items[].document\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument do bloco visual quando kind é \"richContent\".\n  - Path: sections[].rows[].columns[].items[].layout\n    Category: editorial\n    Kind: enum\n    Description: Modo de renderização do bloco visual richContent dentro da coluna.\n  - Path: sections[].rows[].columns[].items[].rootClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS opcional aplicada ao bloco visual richContent.\n  - Path: sections[].rows[].columns[].span.xs\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.sm\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.md\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.lg\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.xl\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xs\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.sm\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.md\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.lg\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xl\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].order.xs\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].order.sm\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].order.md\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].order.lg\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].order.xl\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].hidden.xs\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].hidden.sm\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].hidden.md\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].hidden.lg\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].hidden.xl\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].align\n    Category: layout\n    Kind: enum\n    Description: Alinhamento vertical do conteúdo da coluna.\n  - Path: sections[].rows[].columns[].padding\n    Category: layout\n    Kind: number\n    Description: Padding (em px) interno da coluna.\n  - Path: sections[].rows[].columns[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada à coluna.\n  - Path: actions.submit.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de submissão.\n  - Path: actions.submit.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de submissão.\n  - Path: actions.submit.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de submissão.\n  - Path: actions.submit.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de submissão.\n  - Path: actions.submit.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de submissão.\n  - Path: actions.submit.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de submissão.\n  - Path: actions.submit.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de submissão.\n  - Path: actions.submit.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de submissão.\n  - Path: actions.submit.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de submissão.\n  - Path: actions.submit.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de submissão.\n  - Path: actions.submit.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de submissão.\n  - Path: actions.submit.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.submit.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de submissão.\n  - Path: actions.submit.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de submissão.\n  - Path: actions.submit.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+s\") para o botão de submissão.\n  - Path: actions.cancel.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de cancelar.\n  - Path: actions.cancel.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de cancelar.\n  - Path: actions.cancel.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de cancelar.\n  - Path: actions.cancel.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de cancelar.\n  - Path: actions.cancel.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de cancelar.\n  - Path: actions.cancel.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de cancelar.\n  - Path: actions.cancel.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de cancelar.\n  - Path: actions.cancel.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de cancelar.\n  - Path: actions.cancel.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de cancelar.\n  - Path: actions.cancel.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de cancelar.\n  - Path: actions.cancel.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de cancelar.\n  - Path: actions.cancel.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.cancel.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de cancelar.\n  - Path: actions.cancel.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de cancelar.\n  - Path: actions.cancel.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"esc\") para o botão de cancelar.\n  - Path: actions.reset.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de reset.\n  - Path: actions.reset.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de reset.\n  - Path: actions.reset.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de reset.\n  - Path: actions.reset.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de reset.\n  - Path: actions.reset.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de reset.\n  - Path: actions.reset.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de reset.\n  - Path: actions.reset.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de reset.\n  - Path: actions.reset.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de reset.\n  - Path: actions.reset.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de reset.\n  - Path: actions.reset.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de reset.\n  - Path: actions.reset.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de reset.\n  - Path: actions.reset.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.reset.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de reset.\n  - Path: actions.reset.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de reset.\n  - Path: actions.reset.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+shift+r\") para o botão de reset.\n  - Path: actions.custom\n    Category: actions\n    Kind: array\n    Description: Lista de botões de ação customizados.\n  - Path: actions.custom[]\n    Category: actions\n    Kind: object\n    Description: Configuração de um botão de ação customizado.\n  - Path: actions.custom[].id\n    Category: actions\n    Kind: string\n    Description: ID da ação customizada.\n  - Path: actions.custom[].visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade da ação customizada.\n  - Path: actions.custom[].label\n    Category: actions\n    Kind: string\n    Description: Rótulo da ação customizada.\n  - Path: actions.custom[].icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para a ação customizada.\n  - Path: actions.custom[].color\n    Category: actions\n    Kind: enum\n    Description: Cor da ação customizada.\n  - Path: actions.custom[].variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual da ação customizada.\n  - Path: actions.custom[].size\n    Category: actions\n    Kind: enum\n    Description: Tamanho da ação customizada.\n  - Path: actions.custom[].className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada à ação customizada.\n  - Path: actions.custom[].style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados à ação customizada.\n  - Path: actions.custom[].disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita a ação customizada.\n  - Path: actions.custom[].type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão da ação customizada.\n  - Path: actions.custom[].action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.custom[].tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido na ação customizada.\n  - Path: actions.custom[].loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento na ação customizada.\n  - Path: actions.custom[].shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado para a ação customizada.\n  - Path: actions.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento horizontal da barra de ações.\n  - Path: actions.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões dentro da barra de ações (horizontal/vertical).\n  - Path: actions.spacing\n    Category: layout\n    Kind: enum\n    Description: Espaçamento entre os botões na barra de ações.\n  - Path: actions.sticky\n    Category: layout\n    Kind: boolean\n    Description: Define se a barra de ações deve permanecer visível ao rolar a página.\n  - Path: actions.divider\n    Category: layout\n    Kind: boolean\n    Description: Exibe um divisor superior acima da barra de ações.\n  - Path: actions.placement\n    Category: layout\n    Kind: enum\n    Description: Localização estrutural da barra de ações no layout.\n  - Path: actions.mobile.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento da barra de ações em dispositivos móveis.\n  - Path: actions.mobile.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões em dispositivos móveis.\n  - Path: actions.mobile.collapseToMenu\n    Category: behavior\n    Kind: boolean\n    Description: Em mobile, agrupa ações em um menu (se houver muitas).\n  - Path: actions.containerClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da barra de ações.\n  - Path: actions.containerStyles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da barra de ações.\n  - Path: actions.showSaveButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de submit.\n  - Path: actions.submitButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de submit.\n  - Path: actions.showCancelButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de cancel.\n  - Path: actions.cancelButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de cancel.\n  - Path: actions.showResetButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de reset.\n  - Path: actions.resetButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de reset.\n  - Path: behavior.confirmOnUnsavedChanges\n    Category: behavior\n    Kind: boolean\n    Description: Exibe um alerta se o usuário tentar sair com mudanças não salvas.\n  - Path: behavior.trackHistory\n    Category: behavior\n    Kind: boolean\n    Description: Habilita rastreamento de histórico para desfazer/refazer (se suportado).\n  - Path: behavior.focusFirstError\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, foca automaticamente no primeiro campo com erro.\n  - Path: behavior.scrollToErrors\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, rola a página para exibir o primeiro erro.\n  - Path: behavior.clearAfterSave\n    Category: behavior\n    Kind: boolean\n    Description: Limpa o formulário após uma submissão bem-sucedida.\n  - Path: behavior.redirectAfterSave\n    Category: behavior\n    Kind: string\n    Description: URL para redirecionar após uma submissão bem-sucedida.\n  - Path: behavior.reactiveValidation\n    Category: validation\n    Kind: boolean\n    Description: Ativa validação reativa (em tempo real) em `valueChanges`.\n  - Path: behavior.reactiveValidationDebounceMs\n    Category: validation\n    Kind: number\n    Description: Debounce (em ms) para a validação reativa.\n  - Path: api.saveEndpoint\n    Category: api\n    Kind: string\n    Description: URL para onde os dados do formulário serão enviados (POST/PUT/PATCH).\n  - Path: api.loadEndpoint\n    Category: api\n    Kind: string\n    Description: URL para buscar dados para popular o formulário (GET).\n  - Path: api.saveMethod\n    Category: api\n    Kind: enum\n    Description: Método HTTP para a requisição de salvar.\n  - Path: api.timeout\n    Category: api\n    Kind: number\n    Description: Tempo limite (em ms) para as requisições API.\n  - Path: api.headers\n    Category: api\n    Kind: object\n    Description: Cabeçalhos HTTP personalizados para as requisições API.\n  - Path: api.idField\n    Category: api\n    Kind: string\n    Description: Nome do campo que representa o ID do registro no payload (para PUT/PATCH).\n  - Path: api.beforeSave\n    Category: hooks\n    Kind: expression\n    Description: Hook para pré-processamento de dados antes de enviar para a API.\n  - Path: api.afterLoad\n    Category: hooks\n    Kind: expression\n    Description: Hook para pós-processamento de dados após carregar da API.\n  - Path: messages.updateRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após atualização de registro.\n  - Path: messages.createRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após criação de registro.\n  - Path: messages.updateRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após atualização de registro.\n  - Path: messages.createRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após criação de registro.\n  - Path: messages.confirmations.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de submeter o formulário.\n  - Path: messages.confirmations.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de cancelar.\n  - Path: messages.confirmations.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de resetar o formulário.\n  - Path: messages.confirmations.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para ações customizadas. Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId]\n    Category: messages\n    Kind: object\n    Description: Mensagens da ação customizada (success/error/confirmation). Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId].success\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso para a ação customizada.\n  - Path: messages.customActions.[actionId].error\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro para a ação customizada.\n  - Path: messages.customActions.[actionId].confirmation\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para a ação customizada.\n  - Path: messages.loading.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o envio do formulário.\n  - Path: messages.loading.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o cancelamento.\n  - Path: messages.loading.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o reset do formulário.\n  - Path: messages.loading.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante a execução de uma ação customizada. Substitua `[actionId]` pelo ID da ação.\n  - Path: formRules[].id\n    Category: rules\n    Kind: string\n    Description: ID único da regra de layout.\n  - Path: formRules[].name\n    Category: rules\n    Kind: string\n    Description: Nome amigável da regra de layout.\n  - Path: formRules[].description\n    Category: rules\n    Kind: string\n    Description: Descrição da regra de layout para documentação.\n  - Path: formRules[].metadata.origin\n    Category: rules\n    Kind: enum\n    Description: Origem da regra sugerida pela IA.\n  - Path: formRules[].metadata.reviewStatus\n    Category: rules\n    Kind: enum\n    Description: Status de revisão humana da regra sugerida pela IA.\n  - Path: formRules[].targetType\n    Category: rules\n    Kind: enum\n    Description: Tipo do elemento alvo da regra (campo, seção, ação, linha, coluna ou bloco visual).\n  - Path: formRules[].context\n    Category: rules\n    Kind: enum\n    Description: Contexto legado da regra (quando properties não forem informadas).\n  - Path: formRules[].targets\n    Category: rules\n    Kind: array\n    Description: Lista de IDs dos elementos alvo da regra. O tipo do ID depende de `targetType`.\n  - Path: formRules[].targets[]\n    Category: rules\n    Kind: string\n    Description: ID do alvo da regra.\n  - Path: formRules[].targetFields\n    Category: rules\n    Kind: array\n    Description: Alias legado para alvos de campo.\n  - Path: formRules[].targetFields[]\n    Category: rules\n    Kind: string\n    Description: ID do campo alvo (alias legado).\n  - Path: formRules[].effect.condition\n    Category: rules\n    Kind: expression\n    Description: Condicao canonica da regra, expressa em Json Logic.\n  - Path: formCommandRules\n    Category: rules\n    Kind: array\n    Description: Regras condicionais de comando avaliadas depois que formRules estabilizam valores calculados.\n  - Path: formCommandRules[].condition\n    Category: rules\n    Kind: expression\n    Description: Condicao Json Logic avaliada sobre formData estabilizado, incluindo field values calculados.\n  - Path: formCommandRules[].effects[].kind\n    Category: rules\n    Kind: enum\n    Description: Tipo do efeito de comando. O primeiro corte suporta apenas global-action.\n  - Path: formCommandRules[].effects[].globalAction\n    Category: rules\n    Kind: object\n    Description: GlobalActionRef estruturado executado por GlobalActionService.executeRef quando a regra entra na condicao.\n  - Path: formCommandRules[].policy\n    Category: rules\n    Kind: object\n    Description: Politica operacional do comando: trigger, distinct, distinctBy, debounceMs, errorPolicy e runOnInitialEvaluation.\n  - Path: formRulesState\n    Category: rules\n    Kind: object\n    Description: Estado interno do builder de regras (metadados visuais).\n  - Path: hooks\n    Category: hooks\n    Kind: object\n    Description: Declarações de hooks por estágio do ciclo de vida do formulário.\n  - Path: hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeInit.\n  - Path: hooks.beforeInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterInit.\n  - Path: hooks.afterInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeValidate.\n  - Path: hooks.beforeValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterValidate.\n  - Path: hooks.afterValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeSubmit.\n  - Path: hooks.beforeSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterSubmit.\n  - Path: hooks.afterSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para onError.\n  - Path: hooks.onError[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.onError[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.onError[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.onError[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hints.dataModes.create\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de criação de dados.\n  - Path: hints.dataModes.edit\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de edição de dados.\n  - Path: hints.dataModes.view\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visualização de dados.\n  - Path: hints.uiModes.presentation\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de apresentação da UI.\n  - Path: hints.uiModes.readonly\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de somente leitura da UI.\n  - Path: hints.uiModes.disabled\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo desabilitado da UI.\n  - Path: hints.uiModes.visible\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visibilidade da UI.\n  - Path: fieldMetadata[].id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: fieldMetadata[].version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: fieldMetadata[].context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: fieldMetadata[].createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: fieldMetadata[].updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: fieldMetadata[].tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: fieldMetadata[].cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: fieldMetadata[].style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: fieldMetadata[].dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: fieldMetadata[].name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: fieldMetadata[].label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: fieldMetadata[].placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: fieldMetadata[].hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: fieldMetadata[].tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: fieldMetadata[].description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: fieldMetadata[].selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: fieldMetadata[].variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: fieldMetadata[].density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: fieldMetadata[].links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: fieldMetadata[].group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: fieldMetadata[].order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: fieldMetadata[].width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: fieldMetadata[].isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: fieldMetadata[].controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: fieldMetadata[].dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: fieldMetadata[].source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: fieldMetadata[].materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: fieldMetadata[].materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: fieldMetadata[].materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: fieldMetadata[].materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: fieldMetadata[].materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: fieldMetadata[].materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: fieldMetadata[].materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: fieldMetadata[].prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: fieldMetadata[].suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: fieldMetadata[].iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: fieldMetadata[].iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: fieldMetadata[].mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: fieldMetadata[].format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: fieldMetadata[].validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: fieldMetadata[].validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: fieldMetadata[].required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: fieldMetadata[].validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: fieldMetadata[].validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: fieldMetadata[].validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: fieldMetadata[].validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: fieldMetadata[].validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: fieldMetadata[].validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: fieldMetadata[].validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: fieldMetadata[].validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: fieldMetadata[].validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: fieldMetadata[].validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: fieldMetadata[].validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: fieldMetadata[].validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: fieldMetadata[].validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: fieldMetadata[].validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: fieldMetadata[].validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: fieldMetadata[].validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: fieldMetadata[].validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: fieldMetadata[].validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: fieldMetadata[].validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: fieldMetadata[].validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: fieldMetadata[].validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: fieldMetadata[].validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: fieldMetadata[].validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: fieldMetadata[].validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: fieldMetadata[].validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: fieldMetadata[].validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: fieldMetadata[].validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: fieldMetadata[].validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: fieldMetadata[].validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: fieldMetadata[].validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: fieldMetadata[].validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: fieldMetadata[].validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: fieldMetadata[].validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: fieldMetadata[].validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: fieldMetadata[].validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: fieldMetadata[].validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: fieldMetadata[].debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: fieldMetadata[].options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: fieldMetadata[].endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: fieldMetadata[].valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: fieldMetadata[].displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: fieldMetadata[].filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: fieldMetadata[].queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: fieldMetadata[].cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: fieldMetadata[].hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: fieldMetadata[].visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: fieldMetadata[].formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: fieldMetadata[].tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: fieldMetadata[].filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: fieldMetadata[].dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: fieldMetadata[].conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: fieldMetadata[].conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: fieldMetadata[].dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: fieldMetadata[].dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: fieldMetadata[].dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: fieldMetadata[].dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: fieldMetadata[].resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: fieldMetadata[].enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: fieldMetadata[].dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: fieldMetadata[].suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\nComponent Capabilities:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\nCapability Notes:\n  - Este catalogo descreve inputs e outputs do componente.\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.\n",
+          "content": "Schema Capabilities:\n  - Path: metadata.version\n    Category: metadata\n    Kind: string\n    Description: Versão da configuração do formulário para controle de migração.\n  - Path: metadata.source\n    Category: metadata\n    Kind: enum\n    Description: Origem da configuração do formulário.\n  - Path: metadata.lastUpdated\n    Category: metadata\n    Kind: string\n    Description: Timestamp da última atualização da configuração (ISO-8601).\n  - Path: metadata.schemaId\n    Category: metadata\n    Kind: string\n    Description: ID do schema de origem para reconciliação no servidor.\n  - Path: metadata.schemaContext\n    Category: metadata\n    Kind: object\n    Description: Contexto do schema usado para compor o formulário.\n  - Path: metadata.schemaContext.path\n    Category: metadata\n    Kind: string\n    Description: Path do schema de origem.\n  - Path: metadata.schemaContext.operation\n    Category: metadata\n    Kind: string\n    Description: Operação do schema (ex.: \"get\", \"post\").\n  - Path: metadata.schemaContext.schemaType\n    Category: metadata\n    Kind: enum\n    Description: Tipo do schema (response/request).\n  - Path: metadata.schemaContext.internal\n    Category: metadata\n    Kind: boolean\n    Description: Indica se o schema é interno.\n  - Path: metadata.schemaContext.tenant\n    Category: metadata\n    Kind: string\n    Description: Tenant do schema (se aplicável).\n  - Path: metadata.schemaContext.locale\n    Category: metadata\n    Kind: string\n    Description: Locale do schema (se aplicável).\n  - Path: metadata.serverHash\n    Category: metadata\n    Kind: string\n    Description: Hash dos dados do servidor para detecção de mudanças.\n  - Path: metadata.customizations\n    Category: metadata\n    Kind: array\n    Description: Log de customizações manuais aplicadas ao formulário.\n  - Path: fieldMetadata\n    Category: fields\n    Kind: array\n    Description: Array de metadados dos campos. Usado para referenciar a configuração de campos.\n  - Path: fieldMetadata[]\n    Category: fields\n    Kind: object\n    Description: Item de metadados do campo (FieldMetadata).\n  - Path: editorialContext\n    Category: editorial\n    Kind: object\n    Description: Contexto editorial compartilhado entre os blocos hospedados antes/depois do formulario.\n  - Path: editorialContext.[token]\n    Category: editorial\n    Kind: string\n    Description: Valor simples exposto no contexto editorial.\n  - Path: formBlocksBefore\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado antes do formulario.\n  - Path: formBlocksBefore.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content.\n  - Path: formBlocksBefore.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content editorial.\n  - Path: formBlocksBefore.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes do formulario.\n  - Path: formBlocksBefore.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes do formulario.\n  - Path: formBlocksBefore.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content hospedado antes do formulario.\n  - Path: formBlocksBeforeActions\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois das seções e antes da área principal de ações.\n  - Path: formBlocksBeforeActions.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content antes das ações.\n  - Path: formBlocksBeforeActions.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados antes da área principal de ações.\n  - Path: formBlocksBeforeActions.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado antes da área principal de ações.\n  - Path: formBlocksBeforeActions.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content antes das ações.\n  - Path: formBlocksAfter\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument renderizado depois do formulario inteiro, incluindo a área principal de ações.\n  - Path: formBlocksAfter.kind\n    Category: editorial\n    Kind: string\n    Description: Kind canonico do documento rich content de fechamento.\n  - Path: formBlocksAfter.version\n    Category: editorial\n    Kind: string\n    Description: Versao do documento rich content de fechamento.\n  - Path: formBlocksAfter.nodes\n    Category: editorial\n    Kind: array\n    Description: Lista de RichBlockNode renderizados depois do formulario.\n  - Path: formBlocksAfter.nodes[]\n    Category: editorial\n    Kind: object\n    Description: RichBlockNode editorial hospedado depois do formulario.\n  - Path: formBlocksAfter.context\n    Category: editorial\n    Kind: object\n    Description: Contexto base opcional do documento rich content de fechamento.\n  - Path: sections[].id\n    Category: layout\n    Kind: string\n    Description: ID único da seção.\n  - Path: sections[].title\n    Category: layout\n    Kind: string\n    Description: Título exibido para cada seção do formulário.\n  - Path: sections[].description\n    Category: layout\n    Kind: string\n    Description: Descrição auxiliar exibida abaixo do título da seção.\n  - Path: sections[].icon\n    Category: layout\n    Kind: string\n    Description: Nome do ícone (Material Icons) para o cabeçalho da seção.\n  - Path: sections[].sectionHeader\n    Category: layout\n    Kind: object\n    Description: Configuração rica do header visual da seção, com suporte a avatar por imagem, iniciais ou modo automático.\n  - Path: sections[].sectionHeader.mode\n    Category: layout\n    Kind: enum\n    Description: Estratégia visual do header da seção.\n  - Path: sections[].sectionHeader.sourceField\n    Category: layout\n    Kind: string\n    Description: Campo do formulário usado como origem da imagem do avatar.\n  - Path: sections[].sectionHeader.initialsSourceField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado para derivar iniciais do avatar.\n  - Path: sections[].sectionHeader.altField\n    Category: layout\n    Kind: string\n    Description: Campo textual usado como texto acessivel do avatar e como fallback textual para iniciais quando initialsSourceField nao estiver definido.\n  - Path: sections[].sectionHeader.fallbackIcon\n    Category: layout\n    Kind: string\n    Description: Ícone opcional usado quando o avatar dinâmico estiver vazio ou inválido.\n  - Path: sections[].sectionHeader.emptyState\n    Category: layout\n    Kind: enum\n    Description: Comportamento do header quando os campos de origem ainda não possuem valor.\n  - Path: sections[].sectionHeader.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semântico do avatar da seção, materializado pelo runtime via tokens.\n  - Path: sections[].sectionHeader.initialsMaxLength\n    Category: layout\n    Kind: number\n    Description: Máximo de letras exibidas no avatar textual.\n  - Path: sections[].collapsible\n    Category: layout\n    Kind: boolean\n    Description: Define se a seção pode ser colapsada/expandida pelo usuário.\n  - Path: sections[].collapsed\n    Category: layout\n    Kind: boolean\n    Description: Estado inicial da seção (colapsada/expandida) quando `collapsible` é true.\n  - Path: sections[].gapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após a seção.\n  - Path: sections[].titleGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo do título da seção.\n  - Path: sections[].descriptionGapBottom\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) abaixo da descrição da seção.\n  - Path: sections[].appearance\n    Category: appearance\n    Kind: enum\n    Description: Preset visual do container/cabeçalho da seção.\n  - Path: sections[].stepLabel\n    Category: content\n    Kind: string\n    Description: Rótulo curto do passo exibido antes do título da seção.\n  - Path: sections[].titleStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para o título da seção.\n  - Path: sections[].descriptionStyle\n    Category: appearance\n    Kind: enum\n    Description: Preset de tipografia para a descrição da seção.\n  - Path: sections[].titleColor\n    Category: appearance\n    Kind: string\n    Description: Cor do título da seção (CSS color ou token).\n  - Path: sections[].descriptionColor\n    Category: appearance\n    Kind: string\n    Description: Cor da descrição da seção (CSS color ou token).\n  - Path: sections[].headerAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento horizontal do conteúdo do cabeçalho da seção.\n  - Path: sections[].headerTooltip\n    Category: layout\n    Kind: string\n    Description: Texto de tooltip para o cabeçalho da seção.\n  - Path: sections[].headerActions\n    Category: layout\n    Kind: array\n    Description: Lista de ações iconográficas renderizadas no canto direito do cabeçalho da seção.\n  - Path: sections[].headerActions[].id\n    Category: layout\n    Kind: string\n    Description: ID estável da ação de cabeçalho da seção.\n  - Path: sections[].headerActions[].label\n    Category: layout\n    Kind: string\n    Description: Label acessível usada em tooltip e aria-label da ação.\n  - Path: sections[].headerActions[].icon\n    Category: layout\n    Kind: string\n    Description: Ícone renderizado na ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].action\n    Category: layout\n    Kind: string\n    Description: Nome opcional da ação emitida no customAction; se ausente, o runtime usa o ID.\n  - Path: sections[].headerActions[].tooltip\n    Category: layout\n    Kind: string\n    Description: Tooltip opcional da ação; se ausente, o runtime usa a label.\n  - Path: sections[].headerActions[].color\n    Category: appearance\n    Kind: enum\n    Description: Tom visual da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].visible\n    Category: layout\n    Kind: boolean\n    Description: Controla a visibilidade da ação do cabeçalho da seção.\n  - Path: sections[].headerActions[].disabled\n    Category: layout\n    Kind: boolean\n    Description: Controla o estado desabilitado da ação do cabeçalho da seção.\n  - Path: sections[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da seção.\n  - Path: sections[].styles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da seção.\n  - Path: sections[].rows[].id\n    Category: layout\n    Kind: string\n    Description: ID único da linha dentro de uma seção.\n  - Path: sections[].rows[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da linha (usado em editores e labels).\n  - Path: sections[].rows[].gap\n    Category: layout\n    Kind: number\n    Description: Espaçamento horizontal (em px) entre colunas nesta linha.\n  - Path: sections[].rows[].rowGap\n    Category: layout\n    Kind: number\n    Description: Espaçamento vertical (em px) após esta linha.\n  - Path: sections[].rows[].columns[].id\n    Category: layout\n    Kind: string\n    Description: ID único da coluna dentro de uma linha.\n  - Path: sections[].rows[].columns[].title\n    Category: layout\n    Kind: string\n    Description: Título interno da coluna (usado em editores e labels).\n  - Path: sections[].rows[].columns[].testId\n    Category: layout\n    Kind: string\n    Description: Atributo data-testid aplicado ao container da coluna.\n  - Path: sections[].rows[].columns[].fields\n    Category: layout\n    Kind: array\n    Description: Projeção legada/derivada dos itens kind:\"field\" dentro da coluna.\n  - Path: sections[].rows[].columns[].fields[]\n    Category: layout\n    Kind: string\n    Description: Nome do campo dentro da projeção legada/derivada da coluna.\n  - Path: sections[].rows[].columns[].items\n    Category: layout\n    Kind: array\n    Description: Lista canônica ordenada de itens da coluna: campos e blocos visuais.\n  - Path: sections[].rows[].columns[].items[].kind\n    Category: layout\n    Kind: enum\n    Description: Tipo do item de layout da coluna.\n  - Path: sections[].rows[].columns[].items[].id\n    Category: layout\n    Kind: string\n    Description: ID estável do item de layout dentro do formulário.\n  - Path: sections[].rows[].columns[].items[].fieldName\n    Category: layout\n    Kind: string\n    Description: Nome do campo quando kind é \"field\".\n  - Path: sections[].rows[].columns[].items[].document\n    Category: editorial\n    Kind: object\n    Description: RichContentDocument do bloco visual quando kind é \"richContent\".\n  - Path: sections[].rows[].columns[].items[].layout\n    Category: editorial\n    Kind: enum\n    Description: Modo de renderização do bloco visual richContent dentro da coluna.\n  - Path: sections[].rows[].columns[].items[].rootClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS opcional aplicada ao bloco visual richContent.\n  - Path: sections[].rows[].columns[].span.xs\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.sm\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.md\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.lg\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].span.xl\n    Category: layout\n    Kind: number\n    Description: Largura da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xs\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra pequenas (xs) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.sm\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas pequenas (sm) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.md\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas médias (md) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.lg\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas grandes (lg) no grid system (1-12).\n  - Path: sections[].rows[].columns[].offset.xl\n    Category: layout\n    Kind: number\n    Description: Offset da coluna para telas extra grandes (xl) no grid system (1-12).\n  - Path: sections[].rows[].columns[].order.xs\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].order.sm\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].order.md\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].order.lg\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].order.xl\n    Category: layout\n    Kind: number\n    Description: Ordem visual da coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].hidden.xs\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra pequenas (xs).\n  - Path: sections[].rows[].columns[].hidden.sm\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas pequenas (sm).\n  - Path: sections[].rows[].columns[].hidden.md\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas médias (md).\n  - Path: sections[].rows[].columns[].hidden.lg\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas grandes (lg).\n  - Path: sections[].rows[].columns[].hidden.xl\n    Category: layout\n    Kind: boolean\n    Description: Oculta a coluna para telas extra grandes (xl).\n  - Path: sections[].rows[].columns[].align\n    Category: layout\n    Kind: enum\n    Description: Alinhamento vertical do conteúdo da coluna.\n  - Path: sections[].rows[].columns[].padding\n    Category: layout\n    Kind: number\n    Description: Padding (em px) interno da coluna.\n  - Path: sections[].rows[].columns[].className\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada à coluna.\n  - Path: actions.submit.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de submissão.\n  - Path: actions.submit.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de submissão.\n  - Path: actions.submit.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de submissão.\n  - Path: actions.submit.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de submissão.\n  - Path: actions.submit.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de submissão.\n  - Path: actions.submit.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de submissão.\n  - Path: actions.submit.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de submissão.\n  - Path: actions.submit.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de submissão.\n  - Path: actions.submit.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de submissão.\n  - Path: actions.submit.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de submissão.\n  - Path: actions.submit.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de submissão.\n  - Path: actions.submit.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.submit.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de submissão.\n  - Path: actions.submit.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de submissão.\n  - Path: actions.submit.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+s\") para o botão de submissão.\n  - Path: actions.cancel.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de cancelar.\n  - Path: actions.cancel.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de cancelar.\n  - Path: actions.cancel.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de cancelar.\n  - Path: actions.cancel.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de cancelar.\n  - Path: actions.cancel.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de cancelar.\n  - Path: actions.cancel.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de cancelar.\n  - Path: actions.cancel.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de cancelar.\n  - Path: actions.cancel.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de cancelar.\n  - Path: actions.cancel.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de cancelar.\n  - Path: actions.cancel.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de cancelar.\n  - Path: actions.cancel.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de cancelar.\n  - Path: actions.cancel.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.cancel.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de cancelar.\n  - Path: actions.cancel.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de cancelar.\n  - Path: actions.cancel.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"esc\") para o botão de cancelar.\n  - Path: actions.reset.id\n    Category: actions\n    Kind: string\n    Description: ID do botão de reset.\n  - Path: actions.reset.visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade do botão de reset.\n  - Path: actions.reset.label\n    Category: actions\n    Kind: string\n    Description: Rótulo do botão de reset.\n  - Path: actions.reset.icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para o botão de reset.\n  - Path: actions.reset.color\n    Category: actions\n    Kind: enum\n    Description: Cor do botão de reset.\n  - Path: actions.reset.variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual do botão de reset.\n  - Path: actions.reset.size\n    Category: actions\n    Kind: enum\n    Description: Tamanho do botão de reset.\n  - Path: actions.reset.className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada ao botão de reset.\n  - Path: actions.reset.style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados ao botão de reset.\n  - Path: actions.reset.disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita o botão de reset.\n  - Path: actions.reset.type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão de reset.\n  - Path: actions.reset.action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.reset.tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido no botão de reset.\n  - Path: actions.reset.loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento no botão de reset.\n  - Path: actions.reset.shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado (ex.: \"ctrl+shift+r\") para o botão de reset.\n  - Path: actions.custom\n    Category: actions\n    Kind: array\n    Description: Lista de botões de ação customizados.\n  - Path: actions.custom[]\n    Category: actions\n    Kind: object\n    Description: Configuração de um botão de ação customizado.\n  - Path: actions.custom[].id\n    Category: actions\n    Kind: string\n    Description: ID da ação customizada.\n  - Path: actions.custom[].visible\n    Category: actions\n    Kind: boolean\n    Description: Visibilidade da ação customizada.\n  - Path: actions.custom[].label\n    Category: actions\n    Kind: string\n    Description: Rótulo da ação customizada.\n  - Path: actions.custom[].icon\n    Category: actions\n    Kind: string\n    Description: Ícone (Material Icons) para a ação customizada.\n  - Path: actions.custom[].color\n    Category: actions\n    Kind: enum\n    Description: Cor da ação customizada.\n  - Path: actions.custom[].variant\n    Category: actions\n    Kind: enum\n    Description: Variante visual da ação customizada.\n  - Path: actions.custom[].size\n    Category: actions\n    Kind: enum\n    Description: Tamanho da ação customizada.\n  - Path: actions.custom[].className\n    Category: actions\n    Kind: string\n    Description: Classe CSS aplicada à ação customizada.\n  - Path: actions.custom[].style\n    Category: actions\n    Kind: object\n    Description: Estilos inline aplicados à ação customizada.\n  - Path: actions.custom[].disabled\n    Category: actions\n    Kind: boolean\n    Description: Desabilita a ação customizada.\n  - Path: actions.custom[].type\n    Category: actions\n    Kind: enum\n    Description: Tipo do botão da ação customizada.\n  - Path: actions.custom[].action\n    Category: actions\n    Kind: string\n    Description: Evento customizado disparado ao clicar.\n  - Path: actions.custom[].tooltip\n    Category: actions\n    Kind: string\n    Description: Tooltip exibido na ação customizada.\n  - Path: actions.custom[].loading\n    Category: actions\n    Kind: boolean\n    Description: Exibe estado de carregamento na ação customizada.\n  - Path: actions.custom[].shortcut\n    Category: actions\n    Kind: string\n    Description: Atalho de teclado para a ação customizada.\n  - Path: actions.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento horizontal da barra de ações.\n  - Path: actions.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões dentro da barra de ações (horizontal/vertical).\n  - Path: actions.spacing\n    Category: layout\n    Kind: enum\n    Description: Espaçamento entre os botões na barra de ações.\n  - Path: actions.sticky\n    Category: layout\n    Kind: boolean\n    Description: Define se a barra de ações deve permanecer visível ao rolar a página.\n  - Path: actions.divider\n    Category: layout\n    Kind: boolean\n    Description: Exibe um divisor superior acima da barra de ações.\n  - Path: actions.placement\n    Category: layout\n    Kind: enum\n    Description: Localização estrutural da barra de ações no layout.\n  - Path: actions.mobile.position\n    Category: layout\n    Kind: enum\n    Description: Posicionamento da barra de ações em dispositivos móveis.\n  - Path: actions.mobile.orientation\n    Category: layout\n    Kind: enum\n    Description: Orientação dos botões em dispositivos móveis.\n  - Path: actions.mobile.collapseToMenu\n    Category: behavior\n    Kind: boolean\n    Description: Em mobile, agrupa ações em um menu (se houver muitas).\n  - Path: actions.containerClassName\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao container da barra de ações.\n  - Path: actions.containerStyles\n    Category: appearance\n    Kind: object\n    Description: Estilos inline aplicados ao container da barra de ações.\n  - Path: actions.showSaveButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de submit.\n  - Path: actions.submitButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de submit.\n  - Path: actions.showCancelButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de cancel.\n  - Path: actions.cancelButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de cancel.\n  - Path: actions.showResetButton\n    Category: actions\n    Kind: boolean\n    Description: Legacy: controla visibilidade do botão de reset.\n  - Path: actions.resetButtonLabel\n    Category: actions\n    Kind: string\n    Description: Legacy: rótulo do botão de reset.\n  - Path: behavior.confirmOnUnsavedChanges\n    Category: behavior\n    Kind: boolean\n    Description: Exibe um alerta se o usuário tentar sair com mudanças não salvas.\n  - Path: behavior.trackHistory\n    Category: behavior\n    Kind: boolean\n    Description: Habilita rastreamento de histórico para desfazer/refazer (se suportado).\n  - Path: behavior.focusFirstError\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, foca automaticamente no primeiro campo com erro.\n  - Path: behavior.scrollToErrors\n    Category: behavior\n    Kind: boolean\n    Description: Ao submeter, rola a página para exibir o primeiro erro.\n  - Path: behavior.clearAfterSave\n    Category: behavior\n    Kind: boolean\n    Description: Limpa o formulário após uma submissão bem-sucedida.\n  - Path: behavior.redirectAfterSave\n    Category: behavior\n    Kind: string\n    Description: URL para redirecionar após uma submissão bem-sucedida.\n  - Path: behavior.reactiveValidation\n    Category: validation\n    Kind: boolean\n    Description: Ativa validação reativa (em tempo real) em `valueChanges`.\n  - Path: behavior.reactiveValidationDebounceMs\n    Category: validation\n    Kind: number\n    Description: Debounce (em ms) para a validação reativa.\n  - Path: api.saveEndpoint\n    Category: api\n    Kind: string\n    Description: URL para onde os dados do formulário serão enviados (POST/PUT/PATCH).\n  - Path: api.loadEndpoint\n    Category: api\n    Kind: string\n    Description: URL para buscar dados para popular o formulário (GET).\n  - Path: api.saveMethod\n    Category: api\n    Kind: enum\n    Description: Método HTTP para a requisição de salvar.\n  - Path: api.timeout\n    Category: api\n    Kind: number\n    Description: Tempo limite (em ms) para as requisições API.\n  - Path: api.headers\n    Category: api\n    Kind: object\n    Description: Cabeçalhos HTTP personalizados para as requisições API.\n  - Path: api.idField\n    Category: api\n    Kind: string\n    Description: Nome do campo que representa o ID do registro no payload (para PUT/PATCH).\n  - Path: api.beforeSave\n    Category: hooks\n    Kind: expression\n    Description: Hook para pré-processamento de dados antes de enviar para a API.\n  - Path: api.afterLoad\n    Category: hooks\n    Kind: expression\n    Description: Hook para pós-processamento de dados após carregar da API.\n  - Path: messages.updateRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após atualização de registro.\n  - Path: messages.createRegistrySuccess\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso após criação de registro.\n  - Path: messages.updateRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após atualização de registro.\n  - Path: messages.createRegistryError\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro após criação de registro.\n  - Path: messages.confirmations.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de submeter o formulário.\n  - Path: messages.confirmations.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de cancelar.\n  - Path: messages.confirmations.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação antes de resetar o formulário.\n  - Path: messages.confirmations.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para ações customizadas. Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId]\n    Category: messages\n    Kind: object\n    Description: Mensagens da ação customizada (success/error/confirmation). Substitua `[actionId]` pelo ID da ação.\n  - Path: messages.customActions.[actionId].success\n    Category: messages\n    Kind: string\n    Description: Mensagem de sucesso para a ação customizada.\n  - Path: messages.customActions.[actionId].error\n    Category: messages\n    Kind: string\n    Description: Mensagem de erro para a ação customizada.\n  - Path: messages.customActions.[actionId].confirmation\n    Category: messages\n    Kind: string\n    Description: Mensagem de confirmação para a ação customizada.\n  - Path: messages.loading.submit\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o envio do formulário.\n  - Path: messages.loading.cancel\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o cancelamento.\n  - Path: messages.loading.reset\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante o reset do formulário.\n  - Path: messages.loading.[actionId]\n    Category: messages\n    Kind: string\n    Description: Mensagem exibida durante a execução de uma ação customizada. Substitua `[actionId]` pelo ID da ação.\n  - Path: formRules[].id\n    Category: rules\n    Kind: string\n    Description: ID único da regra de layout.\n  - Path: formRules[].name\n    Category: rules\n    Kind: string\n    Description: Nome amigável da regra de layout.\n  - Path: formRules[].description\n    Category: rules\n    Kind: string\n    Description: Descrição da regra de layout para documentação.\n  - Path: formRules[].metadata.origin\n    Category: rules\n    Kind: enum\n    Description: Origem da regra sugerida pela IA.\n  - Path: formRules[].metadata.reviewStatus\n    Category: rules\n    Kind: enum\n    Description: Status de revisão humana da regra sugerida pela IA.\n  - Path: formRules[].targetType\n    Category: rules\n    Kind: enum\n    Description: Tipo do elemento alvo da regra (campo, seção, ação, linha, coluna ou bloco visual).\n  - Path: formRules[].context\n    Category: rules\n    Kind: enum\n    Description: Contexto legado da regra (quando properties não forem informadas).\n  - Path: formRules[].targets\n    Category: rules\n    Kind: array\n    Description: Lista de IDs dos elementos alvo da regra. O tipo do ID depende de `targetType`.\n  - Path: formRules[].targets[]\n    Category: rules\n    Kind: string\n    Description: ID do alvo da regra.\n  - Path: formRules[].targetFields\n    Category: rules\n    Kind: array\n    Description: Alias legado para alvos de campo.\n  - Path: formRules[].targetFields[]\n    Category: rules\n    Kind: string\n    Description: ID do campo alvo (alias legado).\n  - Path: formRules[].effect.condition\n    Category: rules\n    Kind: expression\n    Description: Condicao canonica da regra, expressa em Json Logic.\n  - Path: formCommandRules\n    Category: rules\n    Kind: array\n    Description: Regras condicionais de comando avaliadas depois que formRules estabilizam valores calculados.\n  - Path: formCommandRules[].condition\n    Category: rules\n    Kind: expression\n    Description: Condicao Json Logic avaliada sobre formData estabilizado, incluindo field values calculados.\n  - Path: formCommandRules[].effects[].kind\n    Category: rules\n    Kind: enum\n    Description: Tipo do efeito de comando. O primeiro corte suporta apenas global-action.\n  - Path: formCommandRules[].effects[].globalAction\n    Category: rules\n    Kind: object\n    Description: GlobalActionRef estruturado executado por GlobalActionService.executeRef quando a regra entra na condicao.\n  - Path: formCommandRules[].policy\n    Category: rules\n    Kind: object\n    Description: Politica operacional do comando: trigger, distinct, distinctBy, debounceMs, errorPolicy e runOnInitialEvaluation.\n  - Path: formRulesState\n    Category: rules\n    Kind: object\n    Description: Estado interno do builder de regras (metadados visuais).\n  - Path: hooks\n    Category: hooks\n    Kind: object\n    Description: Declarações de hooks por estágio do ciclo de vida do formulário.\n  - Path: hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeInit.\n  - Path: hooks.beforeInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterInit.\n  - Path: hooks.afterInit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterInit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterInit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterInit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeValidate.\n  - Path: hooks.beforeValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterValidate.\n  - Path: hooks.afterValidate[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterValidate[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterValidate[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterValidate[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para beforeSubmit.\n  - Path: hooks.beforeSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.beforeSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.beforeSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.beforeSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para afterSubmit.\n  - Path: hooks.afterSubmit[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.afterSubmit[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.afterSubmit[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.afterSubmit[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Declarações de hooks para onError.\n  - Path: hooks.onError[].id\n    Category: hooks\n    Kind: string\n    Description: ID do hook (registrado no host).\n  - Path: hooks.onError[].priority\n    Category: hooks\n    Kind: number\n    Description: Prioridade do hook (maior executa primeiro).\n  - Path: hooks.onError[].timeoutMs\n    Category: hooks\n    Kind: number\n    Description: Timeout em ms para a execucao do hook.\n  - Path: hooks.onError[].args\n    Category: hooks\n    Kind: object\n    Description: Argumentos adicionais passados ao hook.\n  - Path: hints.dataModes.create\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de criação de dados.\n  - Path: hints.dataModes.edit\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de edição de dados.\n  - Path: hints.dataModes.view\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visualização de dados.\n  - Path: hints.uiModes.presentation\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de apresentação da UI.\n  - Path: hints.uiModes.readonly\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de somente leitura da UI.\n  - Path: hints.uiModes.disabled\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo desabilitado da UI.\n  - Path: hints.uiModes.visible\n    Category: form_config\n    Kind: string\n    Description: Dica para o modo de visibilidade da UI.\n  - Path: fieldMetadata[].id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: fieldMetadata[].version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: fieldMetadata[].context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: fieldMetadata[].createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: fieldMetadata[].updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: fieldMetadata[].tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: fieldMetadata[].cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: fieldMetadata[].style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: fieldMetadata[].dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: fieldMetadata[].name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: fieldMetadata[].label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: fieldMetadata[].placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: fieldMetadata[].hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: fieldMetadata[].helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: fieldMetadata[].tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: fieldMetadata[].tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: fieldMetadata[].description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: fieldMetadata[].selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: fieldMetadata[].variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: fieldMetadata[].density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: fieldMetadata[].links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: fieldMetadata[].group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: fieldMetadata[].order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: fieldMetadata[].width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: fieldMetadata[].isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: fieldMetadata[].controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: fieldMetadata[].dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: fieldMetadata[].source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: fieldMetadata[].materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: fieldMetadata[].materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: fieldMetadata[].materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: fieldMetadata[].materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: fieldMetadata[].materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: fieldMetadata[].materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: fieldMetadata[].materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: fieldMetadata[].materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: fieldMetadata[].prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: fieldMetadata[].suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: fieldMetadata[].iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: fieldMetadata[].iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: fieldMetadata[].iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: fieldMetadata[].iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: fieldMetadata[].iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: fieldMetadata[].iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: fieldMetadata[].mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: fieldMetadata[].format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: fieldMetadata[].validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: fieldMetadata[].validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: fieldMetadata[].required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: fieldMetadata[].validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: fieldMetadata[].validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: fieldMetadata[].validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: fieldMetadata[].validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: fieldMetadata[].validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: fieldMetadata[].validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: fieldMetadata[].validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: fieldMetadata[].validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: fieldMetadata[].validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: fieldMetadata[].validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: fieldMetadata[].validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: fieldMetadata[].validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: fieldMetadata[].validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: fieldMetadata[].validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: fieldMetadata[].validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: fieldMetadata[].validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: fieldMetadata[].validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: fieldMetadata[].validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: fieldMetadata[].validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: fieldMetadata[].validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: fieldMetadata[].validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: fieldMetadata[].validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: fieldMetadata[].validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: fieldMetadata[].validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: fieldMetadata[].validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: fieldMetadata[].validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: fieldMetadata[].validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: fieldMetadata[].validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: fieldMetadata[].validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: fieldMetadata[].validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: fieldMetadata[].validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: fieldMetadata[].validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: fieldMetadata[].validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: fieldMetadata[].validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: fieldMetadata[].validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: fieldMetadata[].validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: fieldMetadata[].debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: fieldMetadata[].options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: fieldMetadata[].endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: fieldMetadata[].valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: fieldMetadata[].displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: fieldMetadata[].filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: fieldMetadata[].queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: fieldMetadata[].cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: fieldMetadata[].hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: fieldMetadata[].visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: fieldMetadata[].formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: fieldMetadata[].tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: fieldMetadata[].filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: fieldMetadata[].dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: fieldMetadata[].conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: fieldMetadata[].conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: fieldMetadata[].dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: fieldMetadata[].dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: fieldMetadata[].dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: fieldMetadata[].dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: fieldMetadata[].resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: fieldMetadata[].enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: fieldMetadata[].dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: fieldMetadata[].suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\nComponent Capabilities:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\nCapability Notes:\n  - Este catalogo descreve inputs e outputs do componente.\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "7e3d89b798ba67a90a0cedfe18e0b6ef0cef0c6eab71b1b0e28fc75ab68555af",
+          "contentHash": "3d7166fa9c54731044e538033ce4969a1fe9c4a5cef5bc7fcbf597dbc7c1a765",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-dynamic-form.mjs

@@ -15267,6 +15267,10 @@ class PraxisDynamicForm {
             mask: fieldMeta.mask,
             // Common behavior & MD config to reflect current state in editor
             prefixIcon: fieldMeta.prefixIcon,
+            iconColor: fieldMeta.iconColor,
+            iconClass: fieldMeta.iconClass,
+            iconStyle: fieldMeta.iconStyle,
+            iconFontSize: fieldMeta.iconFontSize,
             prefixIconColor: fieldMeta.prefixIconColor,
             suffixIcon: fieldMeta.suffixIcon,
             suffixIconColor: fieldMeta.suffixIconColor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.0-beta.13",
+  "version": "9.0.0-beta.14",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.0-beta.13",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.13",
-    "@praxisui/metadata-editor": "^9.0.0-beta.13",
-    "@praxisui/rich-content": "^9.0.0-beta.13",
-    "@praxisui/settings-panel": "^9.0.0-beta.13",
-    "@praxisui/visual-builder": "^9.0.0-beta.13",
-    "@praxisui/core": "^9.0.0-beta.13",
+    "@praxisui/ai": "^9.0.0-beta.14",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.14",
+    "@praxisui/metadata-editor": "^9.0.0-beta.14",
+    "@praxisui/rich-content": "^9.0.0-beta.14",
+    "@praxisui/settings-panel": "^9.0.0-beta.14",
+    "@praxisui/visual-builder": "^9.0.0-beta.14",
+    "@praxisui/core": "^9.0.0-beta.14",
     "rxjs": "^7.8.0"
   },
   "dependencies": {