@praxisui/dynamic-fields 9.0.0-beta.13 → 9.0.0-beta.15

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-06-22T22:56:44.148Z",
+  "generatedAt": "2026-06-24T11:17:27.420Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.0-beta.13",
+  "packageVersion": "9.0.0-beta.15",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 76,
@@ -13796,6 +13796,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "tooltip",
           "category": "identity",
@@ -13805,6 +13815,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "description",
           "category": "identity",
@@ -14129,6 +14149,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "mask",
           "category": "appearance",
@@ -18182,9 +18242,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
+          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts",
-          "contentHash": "20eb01632b9f209f4baeaade2ad5f944b4b21ae273531c985a1f11ecf972a2e8",
+          "contentHash": "71598629a171376726d2695c64c56895e952ea38b1fda8ae1e65ffe01a0050f8",
           "sourceKind": "component_definition",
           "sourceId": "pdx-editable-collection",
           "corpusVersion": "1.0.0"
@@ -123318,6 +123378,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "tooltip",
           "category": "identity",
@@ -123327,6 +123397,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "description",
           "category": "identity",
@@ -123651,6 +123731,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "mask",
           "category": "appearance",
@@ -127972,9 +128092,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
+          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts",
-          "contentHash": "20eb01632b9f209f4baeaade2ad5f944b4b21ae273531c985a1f11ecf972a2e8",
+          "contentHash": "71598629a171376726d2695c64c56895e952ea38b1fda8ae1e65ffe01a0050f8",
           "sourceKind": "component_definition",
           "sourceId": "pdx-material-avatar",
           "corpusVersion": "1.0.0"
@@ -253324,6 +253444,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "tooltip",
           "category": "identity",
@@ -253333,6 +253463,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "description",
           "category": "identity",
@@ -253657,6 +253797,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "mask",
           "category": "appearance",
@@ -259793,9 +259973,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
+          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts",
-          "contentHash": "20eb01632b9f209f4baeaade2ad5f944b4b21ae273531c985a1f11ecf972a2e8",
+          "contentHash": "71598629a171376726d2695c64c56895e952ea38b1fda8ae1e65ffe01a0050f8",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-fields",
           "corpusVersion": "1.0.0"
@@ -260710,6 +260890,16 @@
             "ajuda no rodapé do campo"
           ]
         },
+        {
+          "path": "helpText",
+          "category": "identity",
+          "valueKind": "string",
+          "description": "Texto semântico de ajuda publicado pelo schema/DTO.",
+          "intentExamples": [
+            "explicar regra de negócio do campo",
+            "ajuda vinda do backend"
+          ]
+        },
         {
           "path": "tooltip",
           "category": "identity",
@@ -260719,6 +260909,16 @@
             "adicionar tooltip"
           ]
         },
+        {
+          "path": "tooltipOnHover",
+          "category": "identity",
+          "valueKind": "boolean",
+          "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.",
+          "intentExamples": [
+            "mostrar tooltip ao passar o mouse",
+            "ativar dica no hover"
+          ]
+        },
         {
           "path": "description",
           "category": "identity",
@@ -261043,6 +261243,46 @@
             "ícone grande"
           ]
         },
+        {
+          "path": "iconColor",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Cor semântica ou token de cor aplicado ao ícone principal.",
+          "intentExamples": [
+            "ícone em cor primária",
+            "usar token do tema no ícone"
+          ]
+        },
+        {
+          "path": "iconClass",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Classe CSS controlada pelo host para o ícone principal.",
+          "intentExamples": [
+            "usar classe de ícone outlined",
+            "aplicar classe corporativa"
+          ]
+        },
+        {
+          "path": "iconStyle",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Estilo visual semântico do ícone quando o renderer suportar variações.",
+          "intentExamples": [
+            "usar ícone arredondado",
+            "aplicar estilo filled"
+          ]
+        },
+        {
+          "path": "iconFontSize",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Tamanho tipográfico do ícone principal.",
+          "intentExamples": [
+            "ícone com 18px",
+            "ajustar tamanho do ícone"
+          ]
+        },
         {
           "path": "mask",
           "category": "appearance",
@@ -265090,9 +265330,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
+          "content": "Schema Capabilities:\n  - Path: id\n    Category: identity\n    Kind: string\n    Description: Identificador unico da instancia do componente.\n  - Path: version\n    Category: identity\n    Kind: string\n    Description: Versao do schema de metadata (migracao).\n  - Path: context\n    Category: identity\n    Kind: enum\n    Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n  - Path: createdAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de criacao (ISO).\n  - Path: updatedAt\n    Category: misc\n    Kind: string\n    Description: Timestamp de atualizacao (ISO).\n  - Path: tags\n    Category: identity\n    Kind: array\n    Description: Tags para categorizacao e busca.\n  - Path: cssClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS aplicada ao host do componente.\n  - Path: style\n    Category: appearance\n    Kind: object\n    Description: Estilos inline (objeto CSS).\n  - Path: dataAttributes\n    Category: data\n    Kind: object\n    Description: Data attributes para teste/analytics.\n  - Path: name\n    Category: identity\n    Kind: string\n    Description: Identificador único do campo. Essencial para binding.\n  - Path: label\n    Category: identity\n    Kind: string\n    Description: Rótulo principal exibido para o usuário.\n  - Path: placeholder\n    Category: identity\n    Kind: string\n    Description: Texto temporário exibido quando vazio.\n  - Path: hint\n    Category: identity\n    Kind: string\n    Description: Texto de ajuda exibido abaixo do campo.\n  - Path: helpText\n    Category: identity\n    Kind: string\n    Description: Texto semântico de ajuda publicado pelo schema/DTO.\n  - Path: tooltip\n    Category: identity\n    Kind: string\n    Description: Texto exibido ao passar o mouse.\n  - Path: tooltipOnHover\n    Category: identity\n    Kind: boolean\n    Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n  - Path: description\n    Category: identity\n    Kind: string\n    Description: Descrição detalhada (usada em documentação ou helps extensos).\n  - Path: selectionMode\n    Category: behavior\n    Kind: enum\n    Description: Semântica de seleção explícita para controles de escolha.\n  - Path: variant\n    Category: appearance\n    Kind: string\n    Description: Variante visual/semântica do controle.\n  - Path: density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual do shell do controle.\n  - Path: links\n    Category: identity\n    Kind: array\n    Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n  - Path: group\n    Category: identity\n    Kind: string\n    Description: Agrupador lógico do campo.\n  - Path: order\n    Category: layout\n    Kind: number\n    Description: Ordem de exibição do campo.\n  - Path: width\n    Category: layout\n    Kind: string\n    Description: Largura do campo (ex: 50%, 100px).\n  - Path: isFlex\n    Category: layout\n    Kind: boolean\n    Description: Se true, usa flex-grow para preencher espaço.\n  - Path: controlType\n    Category: behavior\n    Kind: enum\n    Description: Tipo do componente de UI (input, select, datepicker, etc).\n  - Path: dataType\n    Category: data\n    Kind: enum\n    Description: Tipo de dado do campo (text, number, date, etc).\n  - Path: source\n    Category: data\n    Kind: enum\n    Description: Origem semantica do campo. Use local para campos do host que nao vem do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporario/local para preenchimento. O dynamic-form omite do submit por padrao.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Politica de submit para sobrescrever o padrao de campos locais/transient.\n  - Path: materialDesign.appearance\n    Category: appearance\n    Kind: enum\n    Description: Aparência do campo Material (fill/outline).\n  - Path: materialDesign.color\n    Category: appearance\n    Kind: enum\n    Description: Tema de cor Material (primary/accent/warn).\n  - Path: materialDesign.floatLabel\n    Category: appearance\n    Kind: enum\n    Description: Comportamento do rótulo flutuante.\n  - Path: materialDesign.subscriptSizing\n    Category: appearance\n    Kind: enum\n    Description: Estratégia de sizing do subscript (erros/hints).\n  - Path: materialDesign.hideRequiredMarker\n    Category: appearance\n    Kind: boolean\n    Description: Oculta o asterisco de campo obrigatório.\n  - Path: materialDesign.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade do campo Material.\n  - Path: materialDesign.disableRipple\n    Category: appearance\n    Kind: boolean\n    Description: Desativa ripple/ondulação em componentes Material.\n  - Path: materialDesign.customPalette\n    Category: appearance\n    Kind: object\n    Description: Override de paleta (primary/accent/warn).\n  - Path: materialDesign.animations\n    Category: appearance\n    Kind: object\n    Description: Configuração de animações (disable, duration, easing).\n  - Path: prefixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido antes do valor.\n  - Path: suffixIcon\n    Category: appearance\n    Kind: string\n    Description: Ícone exibido depois do valor.\n  - Path: iconPosition\n    Category: appearance\n    Kind: enum\n    Description: Posição preferencial do ícone principal.\n  - Path: iconSize\n    Category: appearance\n    Kind: enum\n    Description: Tamanho do ícone.\n  - Path: iconColor\n    Category: appearance\n    Kind: string\n    Description: Cor semântica ou token de cor aplicado ao ícone principal.\n  - Path: iconClass\n    Category: appearance\n    Kind: string\n    Description: Classe CSS controlada pelo host para o ícone principal.\n  - Path: iconStyle\n    Category: appearance\n    Kind: string\n    Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n  - Path: iconFontSize\n    Category: appearance\n    Kind: string\n    Description: Tamanho tipográfico do ícone principal.\n  - Path: mask\n    Category: appearance\n    Kind: string\n    Description: Máscara de input (padrão do componente).\n  - Path: format\n    Category: appearance\n    Kind: string\n    Description: Formato de exibição (ex: pipes).\n  - Path: validators\n    Category: validation\n    Kind: object\n    Description: Objeto contendo todas as regras de validação.\n  - Path: validators.required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatório.\n  - Path: required\n    Category: validation\n    Kind: boolean\n    Description: Campo obrigatorio (alias rapido do validators.required).\n  - Path: validators.requiredMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para required.\n  - Path: validators.email\n    Category: validation\n    Kind: boolean\n    Description: Validação de formato de e-mail.\n  - Path: validators.emailMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para validacao de email.\n  - Path: validators.minLength\n    Category: validation\n    Kind: number\n    Description: Comprimento mínimo do texto.\n  - Path: validators.minLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para minLength.\n  - Path: validators.maxLength\n    Category: validation\n    Kind: number\n    Description: Comprimento máximo do texto.\n  - Path: validators.maxLengthMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para maxLength.\n  - Path: validators.min\n    Category: validation\n    Kind: number\n    Description: Valor numérico mínimo.\n  - Path: validators.minMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para min.\n  - Path: validators.max\n    Category: validation\n    Kind: number\n    Description: Valor numérico máximo.\n  - Path: validators.maxMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para max.\n  - Path: validators.pattern\n    Category: validation\n    Kind: string\n    Description: Regex para validação.\n  - Path: validators.patternMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para pattern.\n  - Path: validators.cpf\n    Category: validation\n    Kind: boolean\n    Description: Validador de CPF (legado).\n  - Path: validators.cnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ (legado).\n  - Path: validators.cpfCnpj\n    Category: validation\n    Kind: boolean\n    Description: Validador automatico CPF/CNPJ (legado).\n  - Path: validators.cnpjAlpha\n    Category: validation\n    Kind: boolean\n    Description: Validador de CNPJ alfanumerico (legado).\n  - Path: validators.cpfMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CPF.\n  - Path: validators.cnpjMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ.\n  - Path: validators.cnpjAlphaMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para CNPJ alfanumerico.\n  - Path: validators.url\n    Category: validation\n    Kind: boolean\n    Description: Validador de URL.\n  - Path: validators.urlMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para URL.\n  - Path: validators.minWords\n    Category: validation\n    Kind: number\n    Description: Mínimo de palavras.\n  - Path: validators.requiredChecked\n    Category: validation\n    Kind: boolean\n    Description: Exige checkbox marcado (ex: termos de uso).\n  - Path: validators.customValidator\n    Category: validation\n    Kind: expression\n    Description: Validador customizado (funcao).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (funcao).\n  - Path: validators.matchField\n    Category: validation\n    Kind: string\n    Description: Campo que deve coincidir (cross-field).\n  - Path: validators.matchFieldMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para matchField.\n  - Path: validators.uniqueValidator\n    Category: validation\n    Kind: expression\n    Description: Validador de unicidade via API (funcao).\n  - Path: validators.uniqueMessage\n    Category: validation\n    Kind: string\n    Description: Mensagem customizada para unicidade.\n  - Path: validators.conditionalValidation\n    Category: validation\n    Kind: array\n    Description: Regras de validacao condicional.\n  - Path: validators.conditionalValidation[].condition\n    Category: validation\n    Kind: expression\n    Description: Condicao para aplicar validadores.\n  - Path: validators.conditionalValidation[].validators\n    Category: validation\n    Kind: object\n    Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n  - Path: validators.validationTrigger\n    Category: validation\n    Kind: enum\n    Description: Gatilho de validacao no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validacao no validator (ms).\n  - Path: validators.showInlineErrors\n    Category: validation\n    Kind: boolean\n    Description: Exibe erros inline (validator).\n  - Path: validators.errorPosition\n    Category: validation\n    Kind: enum\n    Description: Posicao do erro (validator).\n  - Path: validationMode\n    Category: validation\n    Kind: enum\n    Description: Gatilho da validação (change/blur/submit).\n  - Path: debounceTime\n    Category: validation\n    Kind: number\n    Description: Debounce para validação em ms.\n  - Path: options\n    Category: data\n    Kind: array\n    Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n  - Path: endpoint\n    Category: data\n    Kind: string\n    Description: URL para carregar opções remotas.\n  - Path: valueField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de valor nas opções.\n  - Path: displayField\n    Category: data\n    Kind: string\n    Description: Nome da propriedade de texto nas opções.\n  - Path: filterField\n    Category: data\n    Kind: string\n    Description: Campo para filtragem no backend.\n  - Path: queryParams\n    Category: data\n    Kind: object\n    Description: Parâmetros fixos para a query do endpoint.\n  - Path: cacheDuration\n    Category: data\n    Kind: number\n    Description: Duração do cache de dados em ms.\n  - Path: hidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta o campo globalmente.\n  - Path: visibleIn\n    Category: behavior\n    Kind: array\n    Description: Contextos onde o campo é visível.\n  - Path: formHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no formulário.\n  - Path: tableHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas na tabela.\n  - Path: filterHidden\n    Category: behavior\n    Kind: boolean\n    Description: Oculta apenas no filtro.\n  - Path: dependencyFields\n    Category: dependency\n    Kind: array\n    Description: Campos dos quais este campo depende.\n  - Path: conditionalRequired\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para obrigatoriedade declarativa.\n  - Path: conditionalDisplay\n    Category: dependency\n    Kind: expression\n    Description: Condição Json Logic para visibilidade declarativa.\n  - Path: dependencyFilterMap\n    Category: dependency\n    Kind: object\n    Description: Mapeamento de filtro baseado na dependência.\n  - Path: dependencyValuePath\n    Category: dependency\n    Kind: string\n    Description: Caminho no valor da dependência.\n  - Path: dependencyMergeStrategy\n    Category: dependency\n    Kind: enum\n    Description: Estratégia de merge dos dados carregados.\n  - Path: dependencyLoadOnChange\n    Category: dependency\n    Kind: enum\n    Description: Quando recarregar dependência.\n  - Path: resetOnDependentChange\n    Category: dependency\n    Kind: boolean\n    Description: Zera valor se dependência mudar.\n  - Path: enableDependencyCascade\n    Category: dependency\n    Kind: boolean\n    Description: Habilita/desabilita cascata nativa de dependências entre campos.\n  - Path: dependencyDebounceMs\n    Category: dependency\n    Kind: number\n    Description: Delay para reagir à mudança de dependência.\n  - Path: suppressInlineErrorsOnCascade\n    Category: dependency\n    Kind: boolean\n    Description: Suprime erros inline durante cascata.\n  - Path: transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n  - Path: transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n  - Path: textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n  - Path: inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n  - Path: unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n  - Path: readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n  - Path: disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n  - Path: defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n  - Path: ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n  - Path: ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n  - Path: tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n  - Path: accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n",
           "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts",
-          "contentHash": "20eb01632b9f209f4baeaade2ad5f944b4b21ae273531c985a1f11ecf972a2e8",
+          "contentHash": "71598629a171376726d2695c64c56895e952ea38b1fda8ae1e65ffe01a0050f8",
           "sourceKind": "component_definition",
           "sourceId": "praxis-field-shell",
           "corpusVersion": "1.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.0-beta.13",
+  "version": "9.0.0-beta.15",
   "description": "Angular Material-based dynamic form fields for Praxis UI with lazy loading and metadata-driven rendering.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -11,8 +11,8 @@
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
     "rxjs": "^7.8.0",
-    "@praxisui/core": "^9.0.0-beta.13",
-    "@praxisui/cron-builder": "^9.0.0-beta.13"
+    "@praxisui/core": "^9.0.0-beta.15",
+    "@praxisui/cron-builder": "^9.0.0-beta.15"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",