@praxisui/dynamic-fields 8.0.0-beta.21 → 8.0.0-beta.23

package/docs/dynamic-fields-field-selection-guide.md

@@ -64,6 +64,29 @@ Regra pratica para hosts:
 - use `dataSourceKind` para deixar claro se o caso e local, remoto, misto ou especializado;
 - use `icon.key` e `icon.tone` apenas como projecao visual do catalogo canonico, nunca como regra inventada no host.
 
+## Politica visual para labels, icones e prefixos
+
+Campos Material com `appearance: 'fill'` ou `'outline'` e conteudo em
+`matPrefix`/`matSuffix` precisam de cuidado especial. Isso inclui `prefixIcon`,
+`suffixIcon`, `clearButton`, datepicker toggle, seletor de cor, simbolo de moeda
+e controles equivalentes.
+
+Para esses casos, use a configuracao canonica:
+
+```json
+{
+  "materialDesign": {
+    "floatLabel": "always",
+    "subscriptSizing": "dynamic"
+  }
+}
+```
+
+Essa configuracao deve vir da metadata ou da politica global do host que gera os
+campos, nao de CSS local. O Angular Material documenta que, em campos
+`fill`/`outline`, prefixos/sufixos nao se alinham bem com labels em repouso; por
+isso a recomendacao oficial e manter o label sempre flutuante nesses cenarios.
+
 ## 1. Texto livre vs selecao
 
 ### Use `input` / `textarea` quando

package/docs/dynamic-fields-inline-filter-runtime-contract.md

@@ -188,6 +188,30 @@ Por isso:
 
 Esses campos sao de renderizacao.
 
+### Politica de `materialDesign` em filtros
+
+Filtros inline e filtros avancados frequentemente usam icones de prefixo,
+sufixos funcionais, `clearButton`, datepicker toggle ou simbolos de unidade. Em
+campos Material `fill`/`outline`, esses adornos podem conflitar com o label
+quando `floatLabel` fica em `auto`.
+
+A politica recomendada para metadata de filtro e:
+
+```json
+{
+  "materialDesign": {
+    "floatLabel": "always",
+    "subscriptSizing": "dynamic"
+  }
+}
+```
+
+O `praxis-filter` aplica essa politica aos campos promovidos para a barra
+compacta e ao `FormConfig` do formulario avancado. Hosts que fornecem metadata
+propria ou overrides devem preservar essa regra globalmente na metadata de
+filtro, especialmente quando o schema publica `prefixIcon`, `suffixIcon`,
+`clearButton`, campos de data, moeda ou cor.
+
 ## Estados de interacao
 
 Regra canonica da plataforma: