@praxisui/dynamic-fields 9.0.0-beta.33 → 9.0.0-beta.35

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-03T00:15:21.386Z",
+  "generatedAt": "2026-07-03T17:45:06.072Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.0-beta.33",
+  "packageVersion": "9.0.0-beta.35",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 76,
@@ -14302,6 +14302,28 @@
             "sinalizar revisao executiva"
           ]
         },
+        {
+          "path": "presentation.prefix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais como codigo operacional com #; nao persistir o prefixo no valor bruto.",
+          "intentExamples": [
+            "mostrar codigo com #",
+            "prefixar protocolo com PR-"
+          ]
+        },
+        {
+          "path": "presentation.suffix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais; unidades semanticas numericas devem preferir valuePresentation quando aplicavel.",
+          "intentExamples": [
+            "sufixo visual de referencia",
+            "mostrar unidade textual curta"
+          ]
+        },
         {
           "path": "presentation.valuePresentation",
           "category": "appearance",
@@ -18499,9 +18521,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: 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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.prefix\n    Category: appearance\n    Kind: string\n    Description: Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.suffix\n    Category: appearance\n    Kind: string\n    Description: Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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": "6feacc79fd4dc6fe52f5cddf3c9fb0cda66f8376d80368de0d3b8a0d10c0fa1f",
+          "contentHash": "6bfd00700a6ab42b306551991682e0b35046a90ae3ac29a9f38019837724e017",
           "sourceKind": "component_definition",
           "sourceId": "pdx-editable-collection",
           "corpusVersion": "1.0.0"
@@ -124141,6 +124163,28 @@
             "sinalizar revisao executiva"
           ]
         },
+        {
+          "path": "presentation.prefix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais como codigo operacional com #; nao persistir o prefixo no valor bruto.",
+          "intentExamples": [
+            "mostrar codigo com #",
+            "prefixar protocolo com PR-"
+          ]
+        },
+        {
+          "path": "presentation.suffix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais; unidades semanticas numericas devem preferir valuePresentation quando aplicavel.",
+          "intentExamples": [
+            "sufixo visual de referencia",
+            "mostrar unidade textual curta"
+          ]
+        },
         {
           "path": "presentation.valuePresentation",
           "category": "appearance",
@@ -128606,9 +128650,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: 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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.prefix\n    Category: appearance\n    Kind: string\n    Description: Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.suffix\n    Category: appearance\n    Kind: string\n    Description: Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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": "6feacc79fd4dc6fe52f5cddf3c9fb0cda66f8376d80368de0d3b8a0d10c0fa1f",
+          "contentHash": "6bfd00700a6ab42b306551991682e0b35046a90ae3ac29a9f38019837724e017",
           "sourceKind": "component_definition",
           "sourceId": "pdx-material-avatar",
           "corpusVersion": "1.0.0"
@@ -254464,6 +254508,28 @@
             "sinalizar revisao executiva"
           ]
         },
+        {
+          "path": "presentation.prefix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais como codigo operacional com #; nao persistir o prefixo no valor bruto.",
+          "intentExamples": [
+            "mostrar codigo com #",
+            "prefixar protocolo com PR-"
+          ]
+        },
+        {
+          "path": "presentation.suffix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais; unidades semanticas numericas devem preferir valuePresentation quando aplicavel.",
+          "intentExamples": [
+            "sufixo visual de referencia",
+            "mostrar unidade textual curta"
+          ]
+        },
         {
           "path": "presentation.valuePresentation",
           "category": "appearance",
@@ -260744,9 +260810,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: 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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.prefix\n    Category: appearance\n    Kind: string\n    Description: Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.suffix\n    Category: appearance\n    Kind: string\n    Description: Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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": "6feacc79fd4dc6fe52f5cddf3c9fb0cda66f8376d80368de0d3b8a0d10c0fa1f",
+          "contentHash": "6bfd00700a6ab42b306551991682e0b35046a90ae3ac29a9f38019837724e017",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-fields",
           "corpusVersion": "1.0.0"
@@ -262167,6 +262233,28 @@
             "sinalizar revisao executiva"
           ]
         },
+        {
+          "path": "presentation.prefix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais como codigo operacional com #; nao persistir o prefixo no valor bruto.",
+          "intentExamples": [
+            "mostrar codigo com #",
+            "prefixar protocolo com PR-"
+          ]
+        },
+        {
+          "path": "presentation.suffix",
+          "category": "appearance",
+          "valueKind": "string",
+          "description": "Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.",
+          "safetyNotes": "Usar apenas para convencoes visuais; unidades semanticas numericas devem preferir valuePresentation quando aplicavel.",
+          "intentExamples": [
+            "sufixo visual de referencia",
+            "mostrar unidade textual curta"
+          ]
+        },
         {
           "path": "presentation.valuePresentation",
           "category": "appearance",
@@ -266358,9 +266446,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: 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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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 semântica do campo. Use local para campos do host que não vêm do schema backend.\n  - Path: transient\n    Category: data\n    Kind: boolean\n    Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n  - Path: submitPolicy\n    Category: behavior\n    Kind: enum\n    Description: Política de submit para sobrescrever o padrão 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: valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n  - Path: presentation\n    Category: appearance\n    Kind: object\n    Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n  - Path: presentation.presenter\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico de renderizacao em modo apresentacao.\n  - Path: presentation.tone\n    Category: appearance\n    Kind: enum\n    Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n  - Path: presentation.appearance\n    Category: appearance\n    Kind: enum\n    Description: Nivel de enfase visual do apresentador.\n  - Path: presentation.icon\n    Category: appearance\n    Kind: string\n    Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n  - Path: presentation.label\n    Category: identity\n    Kind: string\n    Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n  - Path: presentation.badge\n    Category: appearance\n    Kind: string\n    Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n  - Path: presentation.prefix\n    Category: appearance\n    Kind: string\n    Description: Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.suffix\n    Category: appearance\n    Kind: string\n    Description: Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.\n  - Path: presentation.valuePresentation\n    Category: appearance\n    Kind: object\n    Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n  - Path: presentation.visualization\n    Category: appearance\n    Kind: object\n    Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n  - Path: presentation.visualization.kind\n    Category: appearance\n    Kind: enum\n    Description: Tipo semantico da micro visualizacao de apresentacao.\n  - Path: presentation.visualization.surface\n    Category: layout\n    Kind: enum\n    Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n  - Path: presentation.visualization.size\n    Category: layout\n    Kind: enum\n    Description: Tamanho semantico da micro visualizacao.\n  - Path: presentation.visualization.fallbackText\n    Category: accessibility\n    Kind: string\n    Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n  - Path: presentationRules\n    Category: appearance\n    Kind: array\n    Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n  - Path: presentationRules[].when\n    Category: behavior\n    Kind: object\n    Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n  - Path: presentationRules[].set\n    Category: appearance\n    Kind: object\n    Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\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 obrigatório (alias rápido 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 validação 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 (função).\n  - Path: validators.asyncValidator\n    Category: validation\n    Kind: expression\n    Description: Validador async customizado (função).\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 (função).\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 validação 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 validação no validator.\n  - Path: validators.validationDebounce\n    Category: validation\n    Kind: number\n    Description: Debounce de validação 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: fieldAccess\n    Category: behavior\n    Kind: object\n    Description: Politica canonica de UX para visibilidade/edicao por authorities publicadas pelo backend.\n  - Path: fieldAccess.visibleForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem ver o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.editableForAuthorities\n    Category: behavior\n    Kind: array\n    Description: Authorities que podem editar o campo no runtime quando a UX tiver claims explicitas.\n  - Path: fieldAccess.reason\n    Category: misc\n    Kind: string\n    Description: Justificativa explicativa/auditavel da politica de acesso do campo.\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": "6feacc79fd4dc6fe52f5cddf3c9fb0cda66f8376d80368de0d3b8a0d10c0fa1f",
+          "contentHash": "6bfd00700a6ab42b306551991682e0b35046a90ae3ac29a9f38019837724e017",
           "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.33",
+  "version": "9.0.0-beta.35",
   "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.33",
-    "@praxisui/cron-builder": "^9.0.0-beta.33"
+    "@praxisui/core": "^9.0.0-beta.35",
+    "@praxisui/cron-builder": "^9.0.0-beta.35"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",