@praxisui/table 1.0.0-beta.18 → 1.0.0-beta.20

package/README.md

@@ -430,6 +430,10 @@ Quando `behavior.virtualization.enabled` estiver ativo, as linhas da tabela são
 - `behavior.pagination.position`: `top` | `bottom` | `both`.
 - `behavior.pagination.style`: `default` | `compact` (aplica classe de estilo no paginator).
 
+Nota sobre estratégia (client vs server)
+- Se `behavior.pagination.strategy` não estiver definido, a tabela assume `server` automaticamente quando há `resourcePath` (dados remotos). Caso contrário, usa `client`.
+- O mesmo vale para `behavior.sorting.strategy`.
+
 ## Duplo clique na linha
 
 Ative em Comportamento → Interação.
@@ -491,6 +495,8 @@ Observação: quando informado, o defaultSort é aplicado na carga inicial se n
 
 ## Coluna de ações (sticky)
 
+Nota: por padrão a coluna de ações vem desabilitada. Habilite explicitamente em `actions.row.enabled` e defina as ações desejadas.
+
 - Fixe a coluna de ações no início/fim configurando `actions.row.sticky`:
 
 ```ts
@@ -759,6 +765,8 @@ export class ExampleComponent {
 
 Quando a `<praxis-table>` é conectada a um `resourcePath`, as operações de paginação, ordenação e filtro são delegadas ao backend. Isso garante alta performance, pois apenas os dados visíveis na tela são trafegados pela rede.
 
+Importante: se você não configurar explicitamente as estratégias de paginação/ordenação no `TableConfig`, a tabela resolve automaticamente como `server` quando há `resourcePath`. Se preferir operar no cliente, defina `behavior.pagination.strategy = 'client'` e/ou `behavior.sorting.strategy = 'client'` conscientemente.
+
 O diagrama abaixo detalha a sequência de eventos, desde a interação do usuário na UI até a construção da consulta JPA no servidor.
 
 ```mermaid

package/fesm2022/praxisui-table.mjs

@@ -22812,9 +22812,23 @@ class PraxisTable {
         }
         catch { }
     }
+    resolvePagingStrategy() {
+        const raw = this.config.behavior?.pagination?.strategy;
+        if (raw === 'client' || raw === 'server')
+            return raw;
+        // Default to server when using remote resource and not explicitly configured
+        return this.resourcePath ? 'server' : 'client';
+    }
+    resolveSortingStrategy() {
+        const raw = this.config.behavior?.sorting?.strategy;
+        if (raw === 'client' || raw === 'server')
+            return raw;
+        // Default to server when using remote resource and not explicitly configured
+        return this.resourcePath ? 'server' : 'client';
+    }
     applyDataSourceSettings() {
-        const paginationStrategy = this.config.behavior?.pagination?.strategy ?? 'client';
-        const sortingStrategy = this.config.behavior?.sorting?.strategy ?? 'client';
+        const paginationStrategy = this.resolvePagingStrategy();
+        const sortingStrategy = this.resolveSortingStrategy();
         const isServerPaging = paginationStrategy === 'server';
         const isServerSorting = sortingStrategy === 'server';
         if (this.paginator) {
@@ -23023,7 +23037,7 @@ class PraxisTable {
             // Fall back to inference only if API type is not available or invalid
             apiType = this.inferFieldTypeFromFieldName(field.name);
         }
-        return {
+        const col = {
             field: field.name,
             header: field.label ?? field.name,
             order: field.order,
@@ -23034,6 +23048,47 @@ class PraxisTable {
             _originalApiType: apiType,
             _isApiField: true,
         };
+        // Auto-renderers: map known UI controls to richer cell renderers on first bootstrap
+        // - Avatar: when backend marks controlType 'avatar' (x-ui) or field name matches avatar-like patterns
+        try {
+            this.applyAutoRenderer(field, col);
+        }
+        catch { }
+        return col;
+    }
+    /**
+     * Apply automatic renderer hints based on schema field metadata.
+     * Runs only on initial bootstrap (when columns are derived from schema).
+     */
+    applyAutoRenderer(field, col) {
+        if (!field || !col)
+            return;
+        // Do not override explicit renderer if any (defensive; initial columns have none)
+        if (col.renderer && col.renderer.type)
+            return;
+        const ctl = (field.controlType || '').toString().trim().toLowerCase();
+        const fname = (field.name || '').toString();
+        const lname = fname.toLowerCase();
+        const isAvatarByControl = ctl === 'avatar';
+        if (isAvatarByControl) {
+            // Derive initials from common name fields; leave altField undefined to avoid brittle coupling
+            const initialsExpr = "= (row.nomeCompleto || row.nome || row.fullName || row.name || row.title || '').trim().split(/\\s+/).slice(0,2).map(p => p[0] || '').join('').toUpperCase()";
+            col.renderer = {
+                type: 'avatar',
+                avatar: {
+                    srcField: fname,
+                    // altField intentionally omitted; rely on initialsExpr + title attr if provided later
+                    initialsExpr,
+                    shape: 'circle',
+                    size: 28,
+                },
+            };
+            // Sensible defaults for avatar column
+            col.align = col.align || 'center';
+            if (!col.width)
+                col.width = '56px';
+            return;
+        }
     }
     /**
      * Check if a value is a valid ColumnDataType
@@ -23170,6 +23225,13 @@ class PraxisTable {
                 if (this.paginator) {
                     this.paginator.length = page.totalElements;
                 }
+                // Keep config pagination length in sync for template bindings
+                try {
+                    const beh = this.config.behavior || (this.config.behavior = {});
+                    const pag = beh.pagination || (beh.pagination = {});
+                    pag.totalItems = page.totalElements;
+                }
+                catch { }
             },
             error: (err) => {
                 console.error('[PraxisTable] Data load error', err);