@praxisui/dynamic-fields 3.0.0-beta.5 → 3.0.0-beta.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +12 -0
  2. package/fesm2022/praxisui-dynamic-fields.mjs +973 -269
  3. package/fesm2022/praxisui-dynamic-fields.mjs.map +1 -1
  4. package/index.d.ts +11 -1
  5. package/package.json +5 -5
package/README.md CHANGED
@@ -64,6 +64,18 @@ last_updated: "2026-03-07"
64
64
  - Headless UI and design systems
65
65
  - Data-driven forms
66
66
 
67
+ ## Value Presentation
68
+
69
+ Em estados read-only/display, `dynamic-fields` prefere o contrato canônico `valuePresentation` quando ele existir no metadata do campo.
70
+
71
+ Regras práticas:
72
+ - use `valuePresentation` para valores escalares de display, como `currency`, `number`, `date`, `datetime`, `time`, `percentage` e `boolean`
73
+ - mantenha `format`, `numericFormat`, `currency`, `numberFormat` e `locale` apenas como bridge legado quando necessário
74
+ - `valuePresentation` não é o contrato certo para ranges, selections e IDs semânticos
75
+ - precedência prática: `field.valuePresentation` -> hints legados mapeáveis -> `localization` da superfície/campo -> `LOCALE_ID`
76
+ - `controlType` ajuda o runtime a inferir fallback quando o metadata antigo ainda é usado, mas não substitui a semântica de apresentação
77
+ - em `presentationMode` puro, o runtime renderiza o valor formatado no shell e evita instanciar o componente interativo escondido, reduzindo side effects e deriva de valor
78
+
67
79
  Biblioteca de campos dinâmicos para aplicações Angular (v20+) com Material Design. Renderiza campos a partir de metadados, com carregamento lazy e integração com Reactive Forms.
68
80
 
69
81
  ## Instalação