@praxisui/table 3.0.0-beta.9 → 5.0.0-beta.0

package/README.md

@@ -50,6 +50,8 @@ last_updated: "2026-03-07"
 
 # @praxisui/table
 
+> Estado canônico do workspace Angular: JSON Logic é o único contrato ativo de regras. Menções a DSL neste documento existem apenas como contexto histórico de migração ou referência para payloads legados.
+
 ## Documentation
 
 - Documentação oficial: https://praxisui.dev
@@ -62,6 +64,37 @@ last_updated: "2026-03-07"
 - Governar configuracao de colunas, toolbar e comportamento em runtime
 - Integrar tabelas a fluxos CRUD, IA e editores visuais do ecossistema Praxis UI
 
+## `x-ui.analytics` como fallback tabular canônico
+
+O `@praxisui/table` materializa a familia `analytic-table` quando o `@praxisui/core`
+resolve que uma projection de `x-ui.analytics` continua valida, mas nao e um chart
+inequivoco.
+
+Regras:
+
+- a decisao da familia continua no `@praxisui/core`
+- o `@praxisui/table` nao decide `chart` vs `analytic-table`
+- a tabela apenas materializa a decision/projection recebida
+- a materializacao preserva `dimension`, `metrics`, `sort`, `limit` e agregacao sem
+  inventar defaults semanticos no host
+- `primaryMetrics` e `secondaryMetrics` entram na mesma trilha canonica de execucao
+- projections `timeseries` preservam o valor temporal bruto para manter ordenacao
+  cronologica consistente no fallback tabular
+
+Superficies publicas:
+
+- `AnalyticsTableConfigAdapterService`: converte projection em `TableConfig` local
+- `AnalyticsTableStatsApiService`: executa `praxis.stats` e devolve linhas tabulares
+- `AnalyticsTableContractService`: fachada publica para hosts que querem resolver
+  contrato + dados de tabela analitica sem reimplementar leitura de `x-ui.analytics`
+
+Filtro runtime:
+
+- a projection continua sendo a fonte canonica da semantica analitica
+- o host pode passar `queryContext.filters` em `loadTableViews(..., { queryContexts })`
+- somente `filters` entram no request remoto nesta fase
+- `sort`, `limit` e agregacao continuam vindo da projection publicada
+
 > Componente de tabela empresarial avançado com arquitetura unificada
 
 ## Customization Mode Contract
@@ -115,6 +148,24 @@ Nota: a classe de tema é decisão do host (`.dark-theme` ou `.theme-dark`/`.the
 - **Acessibilidade**: WCAG 2.1 AA compliant
 - **Verificação de Schema**: ETag/If-None-Match com notificações (somente em customização)
 
+## Expansion Hypermedia
+
+O primeiro corte de `behavior.expansion.detail.source.mode = "hypermedia"` é
+`capabilities-first`:
+
+- a row expandida começa em `_links.capabilities`
+- `surfaces`, `actions` e operações canônicas vêm do snapshot agregado retornado
+  pelo backend
+- o detail renderiza um resumo contextual somente leitura, com foco em UX de
+  negócio e affordances disponíveis naquele registro
+- este corte não executa `surface.open` inline nem dispara workflow inline
+- quando o item não expõe `rel="capabilities"`, o runtime aplica fail-closed
+
+Observação de escala:
+- o prefetch por linha continua ativo quando `actions.row.enabled=true`
+- quando apenas o expansion `hypermedia` está ligado, o discovery contextual é
+  resolvido sob demanda ao expandir a linha
+
 ### 📄 Contrato Inline do Filtro
 
 - Referencia canonica: `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-components-guide.md` (slug publicado: `dynamic-fields-inline-components-guide`)
@@ -143,17 +194,17 @@ O novo editor é "column-first" e usa uma tipagem compartilhada com o Editor de
 - Editores de valor dinâmicos: inputs numéricos, listas (CSV/múltipla seleção), datepickers.
 - Grupos lógicos: construa condições com AND/OR/NOT e reordene via arrastar-e-soltar (CDK DragDrop).
 - Preview: execute “Testar” para ver quantas linhas seriam afetadas pelas regras ativas.
-- Import/Export: exporta JSON sem o campo `enabled`; importa com validação de DSL e sanitização de estilos (allowlist).
+- Import/Export: exporta JSON sem o campo `enabled`; importa com validação estrutural de JSON Logic e sanitização de estilos (allowlist).
 
-Exemplos de DSL:
+Exemplos de JSON Logic:
 
-```text
-contains(status, 'Ativo')
-not (status in ['A', 'I'])
-(price >= 10 and price <= 20)
-(createdAt >= '2024-10-01' and createdAt <= '2024-10-31')
-(name == null or name == '')
-active == true
+```json
+{ "contains": [{ "var": "status" }, "Ativo"] }
+{ "!": [{ "in": [{ "var": "status" }, ["A", "I"]] }] }
+{ "and": [{ ">=": [{ "var": "price" }, 10] }, { "<=": [{ "var": "price" }, 20] }] }
+{ "and": [{ ">=": [{ "var": "createdAt" }, "2024-10-01"] }, { "<=": [{ "var": "createdAt" }, "2024-10-31"] }] }
+{ "or": [{ "==": [{ "var": "name" }, null] }, { "==": [{ "var": "name" }, ""] }] }
+{ "==": [{ "var": "active" }, true] }
 ```
 
 Notas sobre enum/CSV:
@@ -294,41 +345,15 @@ Notas
 
 Onde é consumido (preview e runtime)
 
-- Preview/validação no Editor de Regras (usa `DslParser` interno):
-  - Validação da expressão (parse): projects/praxis-table/src/lib/rules-editor/table-rules-editor.component.ts:536
-  - Preview “Testar” (parse + evaluate): projects/praxis-table/src/lib/rules-editor/table-rules-editor.component.ts:909
+- Preview/validação no Editor de Regras:
+  - Authoring canônico manual e visual em JSON Logic: `projects/praxis-table/src/lib/rules-editor/table-rules-editor.component.ts`
 - Runtime na Tabela (aplica `rowConditionalStyles`/`conditionalStyles`):
-  - Parser interno do componente: projects/praxis-table/src/lib/praxis-table.ts:282
+  - JSON Logic canônico + compatibilidade transitória de leitura DSL: `projects/praxis-table/src/lib/praxis-table.ts`
 
 Observação
-- O runtime da tabela já injeta o registry DSL padrão para validação/parse/execução.
-- Para funções realmente custom, injete via input `[dslFunctionRegistry]` no componente.
-
-Exemplo de Provider (recomendado)
+- JSON Logic é o contrato canônico para novas regras e para o editor de regras da tabela.
+- O runtime ainda mantém compatibilidade transitória para regras DSL antigas.
 
-```ts
-import { Injectable } from '@angular/core';
-import { FunctionRegistry } from '@praxisui/specification';
-
-@Injectable({ providedIn: 'root' })
-export class TableDslRegistryFactory {
-  private readonly registry = FunctionRegistry.getInstance<any>('orders-table-rules');
-
-  constructor() {
-    this.registry.clear();
-    this.registry.register('isStatus', (_row: any, value: any, expected: any) =>
-      String(value ?? '').toLowerCase() === String(expected ?? '').toLowerCase(),
-    );
-  }
-
-  get(): FunctionRegistry<any> {
-    return this.registry;
-  }
-}
-
-// Uso no host:
-// <praxis-table [dslFunctionRegistry]="tableDslRegistryFactory.get()" ... />
-```
 
 ### ⚙️ Painel de Configurações
 
@@ -722,7 +747,6 @@ sequenceDiagram
   - `notifyIfOutdated: 'inline' | 'snackbar' | 'both' | 'none' = 'both'`
   - `snoozeMs: number = 86400000`
   - `autoOpenSettingsOnOutdated: boolean = false`
-  - `dslFunctionRegistry: FunctionRegistry<any> | null = null`
 - Outputs:
   - `schemaStatusChange: { outdated: boolean; serverHash?: string; lastVerifiedAt?: string; trigger?: string; tableId?: string }`
     - Emitido tanto na verificação leve (304/200) quanto no bootstrap do schema (primeira carga via `loadSchema()`).
@@ -1494,7 +1518,6 @@ Veja também: `docs/host-crud-integration.md` (guia operacional host) e `project
   - `notifyIfOutdated: 'inline' | 'snackbar' | 'both' | 'none' = 'both'` — seleciona como o runtime publica avisos de drift quando a política operacional estiver habilitada.
   - `snoozeMs: number = 86400000` — tempo de soneca para avisos (ms).
   - `autoOpenSettingsOnOutdated: boolean = false` — abre Configurações ao detectar schema desatualizado.
-  - `dslFunctionRegistry: FunctionRegistry<any> | null = null` — adiciona funções DSL custom sem substituir o registry nativo.
 - Output:
   - `schemaStatusChange: { outdated: boolean; serverHash?: string; lastVerifiedAt?: string; tableId?: string }` — emitido após verificação leve (304/200).
 
@@ -1637,3 +1660,4 @@ Apache-2.0 — consulte `LICENSE` na raiz do workspace para detalhes.
 **Parte do Praxis UI Workspace**
 **Versão**: 2.0.0 (Unified Architecture)
 **Compatibilidade**: Angular 18+
+

package/fesm2022/{praxisui-table-table-ai.adapter-C5rjLb8E.mjs → praxisui-table-table-ai.adapter-CFyyQB26.mjs}

@@ -591,6 +591,20 @@ Columns Analysis:
             'behavior.expansion.detail.source.inlineSchema',
             'behavior.expansion.detail.source.resourcePath.paramsMap',
         ]);
+        const jsonLogicObjectPaths = new Set([
+            'columns[].computed.expression',
+            'columns[].conditionalStyles[].condition',
+            'columns[].conditionalRenderers[].condition',
+            'rowConditionalStyles[].condition',
+            'toolbar.actions[].visibleWhen',
+            'toolbar.actions[].children[].visibleWhen',
+            'actions.row.actions[].visibleWhen',
+            'actions.row.actions[].disabledWhen',
+            'columns[].renderer.button.disabledCondition',
+            'columns[].renderer.toggle.disabledCondition',
+            'columns[].conditionalRenderers[].renderer.button.disabledCondition',
+            'columns[].conditionalRenderers[].renderer.toggle.disabledCondition',
+        ]);
         const recurse = (obj, currentPath) => {
             if (typeof obj !== 'object' || obj === null)
                 return obj;
@@ -613,30 +627,26 @@ Columns Analysis:
                 const prefixMatch = Array.from(allowedPaths).some(p => p.startsWith(newPath + '.') || p.startsWith(newPath + '['));
                 if (exactMatch || prefixMatch) {
                     if (exactMatch
-                        && passthroughObjectPaths.has(newPath)
+                        && (passthroughObjectPaths.has(newPath) || jsonLogicObjectPaths.has(newPath))
                         && typeof obj[key] === 'object'
-                        && obj[key] !== null) {
+                        && obj[key] !== null
+                        && !Array.isArray(obj[key])) {
                         cleanObj[key] = obj[key];
                         continue;
                     }
-                    const val = recurse(obj[key], newPath);
                     if (newPath === 'columns[].computed.expression') {
-                        if (typeof val !== 'string') {
-                            warnings.push(`Computed expression inválida: ${newPath} (não é string)`);
+                        if (!obj[key] || typeof obj[key] !== 'object' || Array.isArray(obj[key])) {
+                            warnings.push(`Computed expression inválida: ${newPath} (deve ser Json Logic)`);
                             continue;
                         }
-                        const trimmed = val.trim();
-                        if (!trimmed) {
+                        if (Object.keys(obj[key]).length === 0) {
                             warnings.push(`Computed expression vazia: ${newPath}`);
                             continue;
                         }
-                        if (trimmed.length > 200) {
-                            warnings.push(`Computed expression muito longa: ${newPath}`);
-                            continue;
-                        }
-                        cleanObj[key] = trimmed;
+                        cleanObj[key] = obj[key];
                         continue;
                     }
+                    const val = recurse(obj[key], newPath);
                     // Se for objeto vazio após limpeza, não inclui (salvo se for intenção explicita de limpar config, mas patch geralmente é aditivo)
                     if (typeof val === 'object' && val !== null && !Array.isArray(val) && Object.keys(val).length === 0) {
                         // ignora