@praxisui/table 8.0.0-beta.18 → 8.0.0-beta.19

package/README.md

@@ -1770,3 +1770,30 @@ 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+
+
+## Discovery contextual em ações por linha
+
+Use `actions.row.discovery.enabled=false` quando a tabela precisar operar em uma
+experiência corporativa estritamente curada pelo host. Nesse modo, o runtime
+mantém somente as ações declaradas em `actions.row.actions[]` e não adiciona
+ações descobertas dinamicamente por HATEOAS/capabilities.
+
+```ts
+actions: {
+  row: {
+    enabled: true,
+    display: 'buttons',
+    discovery: { enabled: false },
+    actions: [
+      { id: 'briefing', label: 'Briefing', action: 'inspect-surfaces' },
+      { id: 'capabilities', label: 'Capabilities', action: 'inspect-actions' },
+    ],
+  },
+}
+```
+
+O campo controla apenas a descoberta contextual de row actions. Ele não desativa
+`behavior.expansion.detail.source.mode="hypermedia"`; quando a expansão
+hypermedia estiver ativa, o detail ainda pode resolver `surfaces` e `actions`
+sob demanda ao expandir a linha. O default continua habilitado quando
+`actions.row.discovery.enabled` é omitido.

package/fesm2022/praxisui-table.mjs

@@ -7596,6 +7596,8 @@ const PRAXIS_TABLE_EDITOR_I18N_CONFIG = {
                 'toolbar.row.width': 'Largura da coluna de ações',
                 'toolbar.row.width.placeholder': 'ex.: 96px, 6rem',
                 'toolbar.row.width.hint': 'Aplica no cabeçalho e nas células.',
+                'toolbar.row.discovery.enabled': 'Descoberta contextual',
+                'toolbar.row.discovery.hint': 'Quando habilitada, a tabela pode adicionar ações contextuais a partir de links HATEOAS e capabilities da linha.',
                 'toolbar.row.sticky': 'Fixar coluna de ações',
                 'toolbar.row.sticky.none': 'Nenhum',
                 'toolbar.row.sticky.start': 'Início',
@@ -8628,6 +8630,8 @@ const PRAXIS_TABLE_EDITOR_I18N_CONFIG = {
                 'toolbar.row.width': 'Actions column width',
                 'toolbar.row.width.placeholder': 'e.g. 96px, 6rem',
                 'toolbar.row.width.hint': 'Applies to header and cells.',
+                'toolbar.row.discovery.enabled': 'Contextual discovery',
+                'toolbar.row.discovery.hint': 'When enabled, the table can add contextual actions from row HATEOAS links and capabilities.',
                 'toolbar.row.sticky': 'Pin actions column',
                 'toolbar.row.sticky.none': 'None',
                 'toolbar.row.sticky.start': 'Start',
@@ -17937,13 +17941,36 @@ class ToolbarActionsEditorComponent {
     ngOnChanges(changes) {
         if (changes['config'] && this.toolbarForm) {
             const toolbar = this.config.toolbar || {};
+            const v2Config = this.config;
+            const rowCfg = v2Config.actions?.row;
+            const bulkCfg = v2Config.actions?.bulk;
+            const beh = rowCfg?.behavior;
+            const displayRaw = rowCfg?.display || 'menu';
+            const displayUI = displayRaw === 'icons' && beh && beh.enabled !== false && beh.maxInline
+                ? 'hybrid'
+                : displayRaw;
             this.toolbarForm.patchValue({
                 toolbarVisible: toolbar.visible || false,
                 toolbarTitle: toolbar.title || '',
                 toolbarSubtitle: toolbar.subtitle || '',
                 toolbarActionsPosition: toolbar.actionsPosition || toolbar.position || 'top',
                 toolbarActionsBackgroundColor: toolbar.actionsBackgroundColor || '',
-                toolbarHeight: toolbar.height || 64,
+                toolbarHeight: toolbar.layout?.height || toolbar.height || 64,
+                rowActionsEnabled: rowCfg?.enabled || false,
+                rowActionsDisplay: displayUI,
+                rowActionsTrigger: rowCfg?.trigger || 'always',
+                maxVisibleRowActions: rowCfg?.maxVisibleActions || 3,
+                rowActionsWidth: rowCfg?.width || '120px',
+                rowActionsSticky: rowCfg?.sticky ?? null,
+                rowActionsMenuIcon: rowCfg?.menuIcon || 'more_vert',
+                rowActionsMenuButtonColor: rowCfg?.menuButtonColor || 'basic',
+                rowActionsDiscoveryEnabled: rowCfg?.discovery?.enabled !== false,
+                rowActionsHeaderLabel: rowCfg?.header?.label || '',
+                rowActionsHeaderIcon: rowCfg?.header?.icon || '',
+                rowActionsHeaderTooltip: rowCfg?.header?.tooltip || '',
+                rowActionsHeaderAlign: rowCfg?.header?.align || 'end',
+                bulkActionsEnabled: bulkCfg?.enabled || false,
+                bulkActionsPosition: bulkCfg?.position || 'toolbar',
             }, { emitEvent: false });
             this.syncActionsFromConfig();
         }
@@ -17981,6 +18008,7 @@ class ToolbarActionsEditorComponent {
             rowActionsSticky: [null],
             rowActionsMenuIcon: ['more_vert'],
             rowActionsMenuButtonColor: ['basic'],
+            rowActionsDiscoveryEnabled: [true],
             rowActionsHeaderLabel: [''],
             rowActionsHeaderIcon: [''],
             rowActionsHeaderTooltip: [''],
@@ -18025,6 +18053,7 @@ class ToolbarActionsEditorComponent {
                     rowActionsSticky: rowCfg?.sticky ?? null,
                     rowActionsMenuIcon: rowCfg?.menuIcon || 'more_vert',
                     rowActionsMenuButtonColor: rowCfg?.menuButtonColor || 'basic',
+                    rowActionsDiscoveryEnabled: rowCfg?.discovery?.enabled !== false,
                     rowActionsHeaderLabel: rowCfg?.header?.label || '',
                     rowActionsHeaderIcon: rowCfg?.header?.icon || '',
                     rowActionsHeaderTooltip: rowCfg?.header?.tooltip || '',
@@ -18238,6 +18267,9 @@ class ToolbarActionsEditorComponent {
                 maxVisibleActions: values.maxVisibleRowActions,
                 menuIcon: values.rowActionsMenuIcon || 'more_vert',
                 menuButtonColor: values.rowActionsMenuButtonColor !== 'basic' ? values.rowActionsMenuButtonColor : undefined,
+                discovery: {
+                    enabled: values.rowActionsDiscoveryEnabled !== false,
+                },
                 header: {
                     label: values.rowActionsHeaderLabel || undefined,
                     icon: values.rowActionsHeaderIcon || undefined,
@@ -19916,6 +19948,14 @@ class ToolbarActionsEditorComponent {
                 </mat-select>
               </mat-form-field>
 
+              <mat-slide-toggle
+                formControlName="rowActionsDiscoveryEnabled"
+                class="toggle-field"
+                [matTooltip]="tx('toolbar.row.discovery.hint', 'When enabled, the table can add contextual actions from row HATEOAS links and capabilities.')"
+              >
+                {{ tx('toolbar.row.discovery.enabled', 'Contextual discovery') }}
+              </mat-slide-toggle>
+
               <mat-form-field appearance="outline">
                 <mat-label>{{ tx('toolbar.row.maxVisible', 'Maximum visible actions') }}</mat-label>
                 <input
@@ -21492,6 +21532,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 </mat-select>
               </mat-form-field>
 
+              <mat-slide-toggle
+                formControlName="rowActionsDiscoveryEnabled"
+                class="toggle-field"
+                [matTooltip]="tx('toolbar.row.discovery.hint', 'When enabled, the table can add contextual actions from row HATEOAS links and capabilities.')"
+              >
+                {{ tx('toolbar.row.discovery.enabled', 'Contextual discovery') }}
+              </mat-slide-toggle>
+
               <mat-form-field appearance="outline">
                 <mat-label>{{ tx('toolbar.row.maxVisible', 'Maximum visible actions') }}</mat-label>
                 <input
@@ -41896,6 +41944,11 @@ class PraxisTable {
             const willAutoDelete = action === 'delete' && (this.autoDelete || bulk.autoDelete);
             const requiresConfirmation = !!bulk.requiresConfirmation || !!willAutoDelete;
             const executeBulk = async () => {
+                const bulkExportFormat = this.resolveBulkExportFormat(action, safeActionConfig);
+                if (bulkExportFormat) {
+                    await this.onExportAction({ format: bulkExportFormat });
+                    return;
+                }
                 if (willAutoDelete) {
                     if (this.isLocalDataModeActive()) {
                         this.debugLog('Local mode: skipping backend bulk delete and emitting bulkAction', { count: rows.length });
@@ -42043,12 +42096,98 @@ class PraxisTable {
             label: toolbarActionConfig?.label || action,
         });
     }
+    resolveBulkExportFormat(action, actionConfig) {
+        if (this.config?.export?.enabled !== true) {
+            return null;
+        }
+        const actionKey = String(action || '').trim().toLowerCase();
+        const looksLikeExportAction = this.isBulkExportActionKey(actionKey);
+        const hasExplicitExportFormat = actionConfig?.exportFormat !== undefined
+            || actionConfig?.format !== undefined
+            || actionConfig?.params?.format !== undefined
+            || actionConfig?.payload?.format !== undefined;
+        if (!looksLikeExportAction && !hasExplicitExportFormat) {
+            return null;
+        }
+        const configuredFormat = this.normalizeExportFormat(actionConfig?.exportFormat
+            ?? actionConfig?.format
+            ?? actionConfig?.params?.format
+            ?? actionConfig?.payload?.format);
+        if (hasExplicitExportFormat) {
+            return configuredFormat && this.isExportFormatEnabled(configuredFormat)
+                ? configuredFormat
+                : null;
+        }
+        const formatFromAction = this.normalizeExportFormat(actionKey.includes('excel') || actionKey.includes('xlsx')
+            ? 'excel'
+            : actionKey.includes('pdf')
+                ? 'pdf'
+                : actionKey.includes('json')
+                    ? 'json'
+                    : actionKey.includes('csv')
+                        ? 'csv'
+                        : null);
+        if (formatFromAction) {
+            return this.isExportFormatEnabled(formatFromAction) ? formatFromAction : null;
+        }
+        if (looksLikeExportAction) {
+            const defaultFormat = this.normalizeExportFormat(this.config?.export?.defaultFormat);
+            if (defaultFormat && this.isExportFormatEnabled(defaultFormat)) {
+                return defaultFormat;
+            }
+            return this.getFirstEnabledExportFormat();
+        }
+        return null;
+    }
+    isBulkExportActionKey(actionKey) {
+        return /(^|[-_.:])export($|[-_.:])|export-selected|bulk-export/.test(actionKey);
+    }
+    normalizeExportFormat(format) {
+        const value = String(format || '').trim().toLowerCase();
+        if (value === 'xlsx')
+            return 'excel';
+        return value === 'excel'
+            || value === 'pdf'
+            || value === 'csv'
+            || value === 'json'
+            || value === 'print'
+            ? value
+            : null;
+    }
+    isExportFormatEnabled(format) {
+        const formats = this.config?.export?.formats;
+        if (!Array.isArray(formats) || formats.length === 0) {
+            return true;
+        }
+        return formats
+            .map((item) => this.normalizeExportFormat(item))
+            .includes(format);
+    }
+    getFirstEnabledExportFormat() {
+        const formats = this.config?.export?.formats;
+        if (!Array.isArray(formats) || formats.length === 0) {
+            return 'csv';
+        }
+        for (const item of formats) {
+            const format = this.normalizeExportFormat(item);
+            if (format)
+                return format;
+        }
+        return null;
+    }
     async onExportAction(event) {
         const format = String(event?.format || '').trim().toLowerCase();
         if (!format)
             return;
         if (this.exportBusy)
             return;
+        if (this.shouldBlockSelectedExportWithoutSelection()) {
+            try {
+                this.snackBar.open(translateTableRuntimeText(this.i18n, 'table.export.noSelection', 'Selecione ao menos um registro para exportar.'), undefined, { duration: 3000 });
+            }
+            catch { }
+            return;
+        }
         this.exportBusy = true;
         this.exportStatusMessage = translateTableRuntimeText(this.i18n, 'table.export.processing', 'Exportando dados...');
         this.cdr.markForCheck();
@@ -42085,6 +42224,10 @@ class PraxisTable {
             this.cdr.markForCheck();
         }
     }
+    shouldBlockSelectedExportWithoutSelection() {
+        const configuredScope = (this.config?.export?.general?.scope || 'auto');
+        return configuredScope === 'selected' && this.selection.selected.length === 0;
+    }
     buildTableExportRequest(format) {
         const general = this.config?.export?.general;
         const scope = (general?.scope || 'auto');
@@ -44194,7 +44337,8 @@ class PraxisTable {
         return this.rowActionCatalogByHref.get(href) || null;
     }
     shouldUseRowDiscovery() {
-        if (this.config.actions?.row?.enabled === true) {
+        const rowActionDiscoveryEnabled = this.config.actions?.row?.discovery?.enabled !== false;
+        if (this.config.actions?.row?.enabled === true && rowActionDiscoveryEnabled) {
             return true;
         }
         const expansionMode = String((this.getExpansionConfig()?.detail?.source || {}).mode || '')
@@ -50601,7 +50745,13 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
                 properties: {
                     enabled: { type: 'boolean' },
                     display: { enum: ['menu', 'buttons', 'icons'] },
-                    trigger: { enum: ['hover', 'always', 'click'] }
+                    trigger: { enum: ['hover', 'always', 'click'] },
+                    discovery: {
+                        type: 'object',
+                        properties: {
+                            enabled: { type: 'boolean' }
+                        }
+                    }
                 }
             },
             effects: [{ kind: 'merge-object', path: 'actions.row' }],
@@ -53253,6 +53403,7 @@ const TABLE_AI_CAPABILITIES = {
         { path: 'actions.row.enabled', category: 'actions', valueKind: 'boolean', description: 'Habilita coluna de ações por linha.', critical: true, intentExamples: ['ativar ações por linha', 'desligar coluna de ações'], safetyNotes: 'Ao desabilitar, verifique se não há ações críticas dependentes.' },
         { path: 'actions.row.display', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.rowActionDisplay, description: 'Modo de exibição das ações (menu/buttons/icons).', dependsOn: 'actions.row.enabled' },
         { path: 'actions.row.trigger', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.rowActionTrigger, description: 'Como as ações aparecem (hover/always/click).', dependsOn: 'actions.row.enabled' },
+        { path: 'actions.row.discovery.enabled', category: 'actions', valueKind: 'boolean', description: 'Controla se a tabela enriquece ações por linha com discovery contextual de HATEOAS/capabilities.', dependsOn: 'actions.row.enabled', safetyNotes: 'Use false quando a experiência precisar mostrar apenas ações curadas pelo host.' },
         { path: 'actions.bulk.enabled', category: 'actions', valueKind: 'boolean', description: 'Habilita ações em lote.', critical: true, intentExamples: ['ativar ações em lote', 'permitir excluir em massa'], safetyNotes: 'Combine com selection.persistSelection e limites de maxSelections.' },
         { path: 'actions.bulk.position', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.bulkActionPosition, description: 'Posição das ações em lote.', dependsOn: 'actions.bulk.enabled' },
         { path: 'actions.context.enabled', category: 'actions', valueKind: 'boolean', description: 'Habilita menu de contexto (clique direito/long press).', critical: true, intentExamples: ['ativar menu de contexto'] },

package/index.d.ts

@@ -1388,9 +1388,15 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
         action: string;
         actionConfig?: any;
     }): Promise<void>;
+    private resolveBulkExportFormat;
+    private isBulkExportActionKey;
+    private normalizeExportFormat;
+    private isExportFormatEnabled;
+    private getFirstEnabledExportFormat;
     onExportAction(event: {
         format: string;
     }): Promise<void>;
+    private shouldBlockSelectedExportWithoutSelection;
     private buildTableExportRequest;
     private resolveEffectiveExportScope;
     private resolveTableExportLoadedItems;

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.18",
+  "version": "8.0.0-beta.19",
   "description": "Advanced data table for Angular (Praxis UI) with editing, filtering, sorting, virtualization, and settings panel integration.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
-    "@praxisui/ai": "^8.0.0-beta.18",
-    "@praxisui/core": "^8.0.0-beta.18",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.18",
-    "@praxisui/dynamic-form": "^8.0.0-beta.18",
-    "@praxisui/metadata-editor": "^8.0.0-beta.18",
-    "@praxisui/rich-content": "^8.0.0-beta.18",
-    "@praxisui/settings-panel": "^8.0.0-beta.18",
-    "@praxisui/table-rule-builder": "^8.0.0-beta.18"
+    "@praxisui/ai": "^8.0.0-beta.19",
+    "@praxisui/core": "^8.0.0-beta.19",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.19",
+    "@praxisui/dynamic-form": "^8.0.0-beta.19",
+    "@praxisui/metadata-editor": "^8.0.0-beta.19",
+    "@praxisui/rich-content": "^8.0.0-beta.19",
+    "@praxisui/settings-panel": "^8.0.0-beta.19",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.19"
   },
   "dependencies": {
     "tslib": "^2.3.0"