@praxisui/core 3.0.0-beta.6 → 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 +18 -0
  2. package/fesm2022/praxisui-core.mjs +2966 -116
  3. package/fesm2022/praxisui-core.mjs.map +1 -1
  4. package/index.d.ts +733 -324
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -974,3 +974,21 @@ Apache-2.0 – veja o `LICENSE` empacotado com esta biblioteca ou o arquivo `LIC
974
974
  **Biblioteca Central do Praxis UI Workspace**
975
975
  **Versão**: 2.0.0 (Unified Architecture)
976
976
  **Compatibilidade**: Angular 20.x | TypeScript 5.8+
977
+ ## Value Presentation
978
+
979
+ `valuePresentation` e o contrato canônico horizontal de apresentação, consumido diretamente por runtimes metadata-driven e indiretamente por superfícies como `table` e `list`.
980
+
981
+ Regras de uso:
982
+ - use `valuePresentation.type` para declarar a natureza do valor exibido (`currency`, `date`, `datetime`, `time`, `number`, `percentage`, `boolean`)
983
+ - deixe `format` como override explicito quando quiser sair do default derivado de `type + localization`
984
+ - use `localization` da superficie como base cultural; nao repita locale/moeda por coluna ou campo sem necessidade real
985
+
986
+ Precedencia:
987
+ 1. override explicito do valor/campo
988
+ 2. `valuePresentation`
989
+ 3. configuracao da superficie
990
+ 4. `LOCALE_ID`
991
+
992
+ Observacoes:
993
+ - `valuePresentation` deve representar valor escalar de display/read-only; nao use para ranges, selections ou IDs semanticos
994
+ - contratos legados como `format`, `numericFormat`, `currency` e `numberFormat` continuam aceitos como bridge de compatibilidade interna, mas novos metadados devem preferir `valuePresentation`