@praxisui/dynamic-form 9.0.0-beta.27 → 9.0.0-beta.28

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-01T19:52:01.852Z",
+  "generatedAt": "2026-07-01T22:59:31.192Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.0-beta.27",
+  "packageVersion": "9.0.0-beta.28",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -2004,10 +2004,10 @@
         },
         {
           "path": "formRulesState",
-          "category": "rules",
+          "category": "metadata",
           "valueKind": "object",
-          "description": "Estado interno do builder de regras (metadados visuais).",
-          "safetyNotes": "Gerado por round-trip do builder. Não deve ser editado manualmente ou pela IA."
+          "description": "Estado interno do builder visual de regras, gerado apenas para round-trip do editor.",
+          "safetyNotes": "Read-only/internal. Não use como alvo de autoria, patch, exemplo ou operação de IA; gere somente formRules e deixe o editor materializar formRulesState."
         },
         {
           "path": "hooks",
@@ -8366,9 +8366,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: helpPresentation\n    Category: appearance\n    Kind: object\n    Description: Politica visual do formulario para exibir hint/helpText dos campos sem alterar a semantica publicada pelos DTOs.\n  - Path: helpPresentation.display\n    Category: appearance\n    Kind: enum\n    Description: Define se a ajuda semantica dos campos fica inline, em icone de ajuda, automatica por densidade, ou oculta visualmente.\n  - Path: helpPresentation.inlineMaxLength\n    Category: appearance\n    Kind: number\n    Description: Tamanho maximo para manter ajuda inline quando display=\"auto\".\n  - Path: helpPresentation.preferPopoverForControls\n    Category: appearance\n    Kind: array\n    Description: Tipos de controle que devem preferir icone de ajuda quando display=\"auto\", como toggle, checkbox ou select.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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[].valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: fieldMetadata[].presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: fieldMetadata[].presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: fieldMetadata[].presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: fieldMetadata[].presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: fieldMetadata[].presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: fieldMetadata[].presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: fieldMetadata[].presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: fieldMetadata[].presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: fieldMetadata[].presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: fieldMetadata[].presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: fieldMetadata[].presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: fieldMetadata[].presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: fieldMetadata[].presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: fieldMetadata[].presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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[].fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldMetadata[].fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\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: helpPresentation\n    Category: appearance\n    Kind: object\n    Description: Politica visual do formulario para exibir hint/helpText dos campos sem alterar a semantica publicada pelos DTOs.\n  - Path: helpPresentation.display\n    Category: appearance\n    Kind: enum\n    Description: Define se a ajuda semantica dos campos fica inline, em icone de ajuda, automatica por densidade, ou oculta visualmente.\n  - Path: helpPresentation.inlineMaxLength\n    Category: appearance\n    Kind: number\n    Description: Tamanho maximo para manter ajuda inline quando display=\"auto\".\n  - Path: helpPresentation.preferPopoverForControls\n    Category: appearance\n    Kind: array\n    Description: Tipos de controle que devem preferir icone de ajuda quando display=\"auto\", como toggle, checkbox ou select.\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: metadata\n    Kind: object\n    Description: Estado interno do builder visual de regras, gerado apenas para round-trip do editor.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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[].valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: fieldMetadata[].presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: fieldMetadata[].presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: fieldMetadata[].presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: fieldMetadata[].presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: fieldMetadata[].presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: fieldMetadata[].presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: fieldMetadata[].presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: fieldMetadata[].presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: fieldMetadata[].presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: fieldMetadata[].presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: fieldMetadata[].presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: fieldMetadata[].presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: fieldMetadata[].presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: fieldMetadata[].presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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[].fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldMetadata[].fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\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": "4a5b5fb3096039768a14041ba1941db8cefe37003e03fdd9fad6a6fd46a223ee",
+          "contentHash": "810f348f20afcf78e465f02773726eaeb9f01b2b86b8116510ec052b3fb1521c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -10276,10 +10276,10 @@
         },
         {
           "path": "formRulesState",
-          "category": "rules",
+          "category": "metadata",
           "valueKind": "object",
-          "description": "Estado interno do builder de regras (metadados visuais).",
-          "safetyNotes": "Gerado por round-trip do builder. Não deve ser editado manualmente ou pela IA."
+          "description": "Estado interno do builder visual de regras, gerado apenas para round-trip do editor.",
+          "safetyNotes": "Read-only/internal. Não use como alvo de autoria, patch, exemplo ou operação de IA; gere somente formRules e deixe o editor materializar formRulesState."
         },
         {
           "path": "hooks",
@@ -14078,9 +14078,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: helpPresentation\n    Category: appearance\n    Kind: object\n    Description: Politica visual do formulario para exibir hint/helpText dos campos sem alterar a semantica publicada pelos DTOs.\n  - Path: helpPresentation.display\n    Category: appearance\n    Kind: enum\n    Description: Define se a ajuda semantica dos campos fica inline, em icone de ajuda, automatica por densidade, ou oculta visualmente.\n  - Path: helpPresentation.inlineMaxLength\n    Category: appearance\n    Kind: number\n    Description: Tamanho maximo para manter ajuda inline quando display=\"auto\".\n  - Path: helpPresentation.preferPopoverForControls\n    Category: appearance\n    Kind: array\n    Description: Tipos de controle que devem preferir icone de ajuda quando display=\"auto\", como toggle, checkbox ou select.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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[].valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: fieldMetadata[].presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: fieldMetadata[].presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: fieldMetadata[].presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: fieldMetadata[].presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: fieldMetadata[].presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: fieldMetadata[].presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: fieldMetadata[].presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: fieldMetadata[].presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: fieldMetadata[].presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: fieldMetadata[].presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: fieldMetadata[].presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: fieldMetadata[].presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: fieldMetadata[].presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: fieldMetadata[].presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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[].fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldMetadata[].fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\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: helpPresentation\n    Category: appearance\n    Kind: object\n    Description: Politica visual do formulario para exibir hint/helpText dos campos sem alterar a semantica publicada pelos DTOs.\n  - Path: helpPresentation.display\n    Category: appearance\n    Kind: enum\n    Description: Define se a ajuda semantica dos campos fica inline, em icone de ajuda, automatica por densidade, ou oculta visualmente.\n  - Path: helpPresentation.inlineMaxLength\n    Category: appearance\n    Kind: number\n    Description: Tamanho maximo para manter ajuda inline quando display=\"auto\".\n  - Path: helpPresentation.preferPopoverForControls\n    Category: appearance\n    Kind: array\n    Description: Tipos de controle que devem preferir icone de ajuda quando display=\"auto\", como toggle, checkbox ou select.\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: metadata\n    Kind: object\n    Description: Estado interno do builder visual de regras, gerado apenas para round-trip do editor.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: fieldMetadata[].transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: fieldMetadata[].submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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[].valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: fieldMetadata[].presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: fieldMetadata[].presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: fieldMetadata[].presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: fieldMetadata[].presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: fieldMetadata[].presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: fieldMetadata[].presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: fieldMetadata[].presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: fieldMetadata[].presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: fieldMetadata[].presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: fieldMetadata[].presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: fieldMetadata[].presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: fieldMetadata[].presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: fieldMetadata[].presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: fieldMetadata[].presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: fieldMetadata[].presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: fieldMetadata[].validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: fieldMetadata[].validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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[].fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldMetadata[].fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldMetadata[].fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\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": "4a5b5fb3096039768a14041ba1941db8cefe37003e03fdd9fad6a6fd46a223ee",
+          "contentHash": "810f348f20afcf78e465f02773726eaeb9f01b2b86b8116510ec052b3fb1521c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-dynamic-form.mjs

@@ -2322,7 +2322,6 @@ const FORM_AI_CAPABILITIES = {
         'praxis-row-configurator',
         'praxis-field-configurator',
         'praxis-behavior-editor',
-        'praxis-rules-editor',
         'praxis-section-preset-picker'
     ],
     notes: [
@@ -3997,10 +3996,10 @@ const FORM_AI_CAPABILITIES = {
         ...generateRulePropertyWhenFalseCapabilities(FormRuleTargetType.VisualBlock, RULE_PROPERTY_SCHEMA.visualBlock),
         {
             path: 'formRulesState',
-            category: 'rules',
+            category: 'metadata',
             valueKind: 'object',
-            description: 'Estado interno do builder de regras (metadados visuais).',
-            safetyNotes: 'Gerado por round-trip do builder. Não deve ser editado manualmente ou pela IA.',
+            description: 'Estado interno do builder visual de regras, gerado apenas para round-trip do editor.',
+            safetyNotes: 'Read-only/internal. Não use como alvo de autoria, patch, exemplo ou operação de IA; gere somente formRules e deixe o editor materializar formRulesState.',
         },
         // =============================================================================
         // FORM CONFIG - HOOKS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.0-beta.27",
+  "version": "9.0.0-beta.28",
   "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.27",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.27",
-    "@praxisui/metadata-editor": "^9.0.0-beta.27",
-    "@praxisui/rich-content": "^9.0.0-beta.27",
-    "@praxisui/settings-panel": "^9.0.0-beta.27",
-    "@praxisui/visual-builder": "^9.0.0-beta.27",
-    "@praxisui/core": "^9.0.0-beta.27",
+    "@praxisui/ai": "^9.0.0-beta.28",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.28",
+    "@praxisui/metadata-editor": "^9.0.0-beta.28",
+    "@praxisui/rich-content": "^9.0.0-beta.28",
+    "@praxisui/settings-panel": "^9.0.0-beta.28",
+    "@praxisui/visual-builder": "^9.0.0-beta.28",
+    "@praxisui/core": "^9.0.0-beta.28",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/config-editor/praxis-dynamic-form-config-editor.json-api.md

@@ -103,7 +103,7 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form-config
 | `messages` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `hooks` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `formRules` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
-| `formRulesState` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | Internal | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hints` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `api` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
 | `metadata` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
@@ -141,7 +141,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | messages | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Active. |
 | hooks | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Active. |
 | formRules | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Active. |
-| formRulesState | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Active. |
+| formRulesState | Estado interno de round-trip do builder visual. | verified | internal-derived | Gerado pelo editor a partir de `formRules`; nao escrever diretamente. |
 
 ### Nested configuration blocks
 
@@ -154,7 +154,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `messages` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
 | `hooks` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
 | `formRules` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
-| `formRulesState` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | internal-derived | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hints` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
 | `api` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
 
@@ -331,7 +331,7 @@ A entrada operacional vem via `SETTINGS_PANEL_DATA` (injetado pelo settings pane
 | `messages` | Active | Editado na aba Mensagens. |
 | `hooks` | Active | Editado na aba Hooks e JSON. |
 | `formRules` | Active | Gerado pela aba Regras (visual builder). |
-| `formRulesState` | Active | Persistido para round-trip sem perda. |
+| `formRulesState` | Internal | Persistido somente como estado de round-trip do builder visual; nao e contrato autoravel. |
 | `hints` | Active | Editado na aba Dicas e Tooltips. |
 | `api` | Partial | Sem aba dedicada; passa por JSON editor quando presente. |
 | `metadata` | Partial | Mantido em round-trip; sem painel dedicado. |
@@ -412,7 +412,7 @@ Correcao: e diff estrutural para UX do painel, nao auditoria de negocio.
 | `messages` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `hooks` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `formRules` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
-| `formRulesState` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | Internal | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hints` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
 | `api` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
 | `metadata` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |

package/src/lib/praxis-dynamic-form.json-api.md

@@ -129,7 +129,7 @@ Essa fronteira preserva a premissa de plataforma: o formulario materializa e exp
 | `messages` | not-specified | not-specified | n/a | Partial | Chaves principais de submit/confirmacao usadas; contrato e mais amplo. |
 | `formRules` | not-specified | not-specified | n/a | Active | Aplicadas no pipeline de regras do runtime. |
 | `formCommandRules` | not-specified | not-specified | n/a | Active | Regras condicionais de comando avaliadas sobre `formData` estabilizado depois de `formRules`; primeiro corte suporta `global-action`. |
-| `formRulesState` | not-specified | not-specified | n/a | Active | Persistido para round-trip do builder visual. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | Internal | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hooks` | not-specified | not-specified | n/a | Active | Integracao de ciclo (before/after) via runtime de hooks. |
 | `hints` | not-specified | not-specified | n/a | Declared-only | Mantido no contrato/editor; sem render dedicado no template principal. |
 | `helpPresentation` | `FormHelpPresentationConfig` | No | `{ display: "inline" }` | Active | Politica visual para exibir `hint`/`helpText` dos campos sem alterar semantica dos DTOs; erros de validacao continuam inline. |
@@ -193,7 +193,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `api` | not-specified | not-specified | n/a | component-defined | Declarado no modelo; sem binding operacional direto no runtime atual. |
 | `messages` | not-specified | not-specified | n/a | component-defined | Chaves principais de submit/confirmacao usadas; contrato e mais amplo. |
 | `formRules` | not-specified | not-specified | n/a | component-defined | Aplicadas no pipeline de regras do runtime. |
-| `formRulesState` | not-specified | not-specified | n/a | component-defined | Persistido para round-trip do builder visual. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | internal-derived | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hooks` | not-specified | not-specified | n/a | component-defined | Integracao de ciclo (before/after) via runtime de hooks. |
 | `sections[].sectionHeader` | `FormSectionHeaderConfig` | No | n/a | Active | Header visual rico da seção com suporte a avatar dinâmico resolvido a partir de `formData`. |
 
@@ -709,7 +709,7 @@ Precedencias importantes:
 | `api` | Declared-only | Declarado no modelo; sem binding operacional direto no runtime atual. |
 | `messages` | Partial | Chaves principais de submit/confirmacao usadas; contrato e mais amplo. |
 | `formRules` | Active | Aplicadas no pipeline de regras do runtime. |
-| `formRulesState` | Active | Persistido para round-trip do builder visual. |
+| `formRulesState` | Internal | Persistido somente como estado de round-trip do builder visual; nao e contrato autoravel. |
 | `hooks` | Active | Integracao de ciclo (before/after) via runtime de hooks. |
 | `hints` | Declared-only | Mantido no contrato/editor; sem render dedicado no template principal. |
 
@@ -886,7 +886,7 @@ O runtime emite `target-not-found` quando uma regra aponta para `section`, `row`
 | `api` | not-specified | not-specified | n/a | Declared-only | Declarado no modelo; sem binding operacional direto no runtime atual. |
 | `messages` | not-specified | not-specified | n/a | Partial | Chaves principais de submit/confirmacao usadas; contrato e mais amplo. |
 | `formRules` | not-specified | not-specified | n/a | Active | Aplicadas no pipeline de regras do runtime. |
-| `formRulesState` | not-specified | not-specified | n/a | Active | Persistido para round-trip do builder visual. |
+| `formRulesState` | internal-round-trip | Gerado pelo builder visual; nao e alvo de autoria manual ou IA. | n/a | Internal | Estado visual derivado de `formRules` para reabertura do editor. |
 | `hooks` | not-specified | not-specified | n/a | Active | Integracao de ciclo (before/after) via runtime de hooks. |
 | `hints` | not-specified | not-specified | n/a | Declared-only | Mantido no contrato/editor; sem render dedicado no template principal. |