@praxisui/table 1.0.0-beta.42 → 1.0.0-beta.44

package/README.md

@@ -498,6 +498,7 @@ onRowDoubleClick(evt: { action: string; row: any }) {
 
 - Configure em `behavior.sorting.defaultSort`.
 - Aceita objeto único (coluna/direção) ou array para multi‑sort.
+- Status runtime atual: `behavior.sorting.multiSort` está **schema-only** (apenas 1 critério efetivo em runtime).
 
 Exemplos:
 
@@ -523,6 +524,13 @@ sorting: {
 ```
 
 Observação: quando informado, o defaultSort é aplicado na carga inicial se não houver estado de ordenação ativo.
+Observação enterprise: para evitar ambiguidade de contrato, mantenha `multiSort: false` no runtime atual. Se um array for informado em `defaultSort`, trate como payload de compatibilidade/roadmap e valide no host como single-sort efetivo.
+
+### Roadmap / migração de multiSort
+
+- Curto prazo: `multiSort` segue schema-only no runtime.
+- Recomendação de migração: desenhar integrações com fallback para ordenação única (`column` + `direction`).
+- Planejamento: quando multi-sort runtime for implementado, publicar release note com guia de ativação gradual (feature-flag + validação de payload legado).
 
 ## Coluna de ações (sticky)
 
@@ -1105,7 +1113,8 @@ export class MyComponent {
     this.configService.setConfig(this.tableConfig);
 
     // Verificar recursos disponíveis
-    const hasMultiSort = this.configService.isFeatureEnabled('multiSort');
+    // No runtime atual, multiSort permanece schema-only.
+    const hasMultiSort = false;
     const hasBulkActions = this.configService.isFeatureEnabled('bulkActions');
   }
 }