@praxisui/table 3.0.0-beta.5 → 3.0.0-beta.7

package/README.md

@@ -382,6 +382,27 @@ Neste exemplo:
 - A tabela fará requisições como `POST /api/human-resources/departamentos/filter` para obter os dados e `GET /schemas/filtered?path=/api/human-resources/departamentos/all&operation=get&schemaType=response` para obter o schema estrutural usado no bootstrap das colunas.
 - `enableCustomization` controla explicitamente o gate de edição visual. O default canônico agora é `false`; declare `[enableCustomization]="true"` quando o host quiser expor customização e surfaces editoriais.
 
+### Consulta Declarativa com `queryContext`
+
+Para orquestração entre widgets em `praxis-dynamic-page`, o contrato semântico primário da tabela passa a ser `queryContext`.
+
+```html
+<praxis-table
+  resourcePath="human-resources/departamentos"
+  [queryContext]="{
+    filters: { status: 'ACTIVE' },
+    sort: ['nome,asc'],
+    page: { index: 0, size: 25 }
+  }"
+></praxis-table>
+```
+
+Regras atuais:
+
+- `queryContext.filters` já participa do pipeline efetivo da tabela
+- `filterCriteria` continua aceito como bridge legada de compatibilidade
+- em novo authoring, examples e bindings, prefira `queryContext`
+
 ### Empty State + Quick Connect (sem `resourcePath`)
 
 Se a tabela for renderizada sem `resourcePath`, um cartão de "Empty State" é exibido convidando a conectar o componente a um recurso. Basta clicar em "Conectar a recurso" para abrir um painel rápido com um único campo:
@@ -1491,9 +1512,16 @@ Notas rápidas (Flow ETag no Filter):
 
 ## Formatação de Colunas (format)
 
-Cada coluna pode declarar `type` e uma string de formatação `format` consumida pelo `DataFormattingService`. Os tipos suportados são: `string`, `number`, `currency`, `percentage`, `date`, `boolean`, `custom`.
+Cada coluna pode declarar `type` e uma string de formatação `format` consumida pelo `DataFormattingService`. Os tipos suportados são: `string`, `number`, `currency`, `percentage`, `date`, `datetime`, `time`, `boolean`, `custom`.
 
-Regra geral: a formatação só é aplicada quando há `format` não vazio e `type !== 'custom'`.
+Regra geral:
+- `format` explícito continua com precedência máxima.
+- Para `number`, `currency`, `percentage`, `date`, `datetime` e `time`, a tabela também consegue derivar formatação básica a partir de `type + config.localization`, mesmo quando `format` estiver ausente.
+- `string`, `boolean` e `custom` continuam conservadores; nesses casos, use `format` explícito quando precisar de transformação.
+
+Nota de plataforma:
+- o contrato público da tabela continua sendo `column.type + config.localization + format`.
+- a tabela converge internamente para a semântica canônica horizontal do core, mas não expõe `valuePresentation` como bloco público de configuração de coluna.
 
 Tipos e padrões de `format`:
 - number (DecimalPipe)
@@ -1525,6 +1553,23 @@ Exemplos de ColumnDefinition:
 { field: 'ativo', type: 'boolean', format: 'yes-no', header: 'Ativo' }
 ```
 
+Exemplos com defaults implícitos por `type + localization`:
+```ts
+{
+  localization: {
+    locale: 'pt-BR',
+    currency: { code: 'BRL', symbol: 'R$', position: 'before', spacing: true, precision: 2 },
+    dateTime: { dateFormat: 'dd/MM/yyyy', timeFormat: 'HH:mm', dateTimeFormat: 'dd/MM/yyyy HH:mm', firstDayOfWeek: 1 },
+    number: { decimalSeparator: ',', thousandsSeparator: '.', defaultPrecision: 2, negativeSign: '-', negativeSignPosition: 'before' },
+  },
+  columns: [
+    { field: 'salario', type: 'currency', header: 'Salário' },
+    { field: 'criadoEm', type: 'date', header: 'Criado em' },
+    { field: 'taxa', type: 'percentage', header: 'Taxa' },
+  ],
+}
+```
+
 Observações:
 - `|nosep` remove separadores de milhar da saída formatada.
 - Para datas inválidas ou valores não numéricos, o serviço retorna o valor original (com aviso no console).