@praxisui/crud 10.0.0-rc.14 → 10.0.0-rc.15

package/README.md

@@ -344,6 +344,33 @@ The host does not need to call `HttpClient`, rebuild create schema URLs, or own
 a second launcher. Absence of the HATEOAS link keeps the operation unavailable;
 the runtime does not infer permission from labels, tags, or frontend flags.
 
+## Governed Two-Phase Bulk Operations
+
+`PraxisCrudComponent` discovers governed two-phase bulk operations published by
+`praxis-metadata-starter` on collection capabilities (`actions[].execution.bulk`
+for `DOMAIN_COMMAND` and `operations['bulk-update'].bulk` for `UNIFORM_UPDATE`)
+and materializes them in the contextual bulk selection toolbar:
+
+1. **Pre-evaluation gates**: validates `limits.maxTargets` before evaluation and
+   resolves `expectedVersion` (`ETag`) via `_links.self` only when
+   `preconditions.resourceVersion === 'REQUIRED'`.
+2. **Phase 1 — Immutable Proposal (`PraxisBulkOperationDialogComponent` / `PraxisBulkEditDialogComponent`)**:
+   hydrates command parameters (unwrapping `/properties/parameters` and OpenAPI
+   `$ref` definitions with a resource-and-action-scoped `formId`) or
+   `@BulkEditable` fields (`SET` / `CLEAR`), submits the evaluation request, and
+   renders target eligibility totals (`executable`, `blocked`) and per-item
+   diagnostics.
+3. **Phase 2 — Transactional Confirmation & Reconciliation**: confirms the
+   approved `proposalId` with an `Idempotency-Key`, polls asynchronous
+   executions until terminal state (`COMPLETED`, `COMPLETED_WITH_ERRORS`,
+   `CANCELLED`, `STOPPED`, `RECONCILIATION_REQUIRED`), aggregates all rejection
+   categories (`denied`, `invalid`, `conflict`, `notProcessed`, `unknown`),
+   clears table selection, refreshes the collection, and re-fetches capabilities
+   when `refresh.capabilities === true`.
+
+Unavailable bulk operations (`availability.allowed === false`) remain visible
+but disabled in the bulk toolbar with their canonical translated reason tooltip.
+
 ## Visual Authoring
 
 The package publishes the CRUD-specific authoring surface:
@@ -377,6 +404,7 @@ The manifest owns CRUD orchestration only. It delegates table, form, field, and
 Main exports:
 
 - `PraxisCrudComponent`
+- `PraxisBulkOperationDialogComponent`, `PraxisBulkEditDialogComponent`
 - `CrudLauncherService`
 - `DynamicFormDialogHostComponent`
 - `CrudMetadata`, `CrudActionFormContract`, `CrudDefaults`, `CrudParamMapping`

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T11:31:33.532Z",
+  "generatedAt": "2026-10-14T16:04:24.084Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "10.0.0-rc.14",
+  "packageVersion": "10.0.0-rc.15",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-crud.mjs

@@ -104,6 +104,15 @@ class PraxisBulkOperationDialogComponent {
             this.action.requestSchemaUrl ||
             null);
     }
+    getParametersFormId() {
+        const resourcePart = String(this.data.resourceKey || this.data.resourcePath || 'resource')
+            .trim()
+            .replace(/[^a-zA-Z0-9_-]+/g, '-');
+        const actionPart = String(this.action.id || 'action')
+            .trim()
+            .replace(/[^a-zA-Z0-9_-]+/g, '-');
+        return `bulk-params-${resourcePart}-${actionPart}`;
+    }
     onParametersChange(event) {
         const raw = event?.formData ?? event?.value ?? event;
         if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
@@ -474,7 +483,7 @@ class PraxisBulkOperationDialogComponent {
             <div class="praxis-bulk-dialog__section">
               <h3 class="praxis-bulk-dialog__section-title">Parâmetros da Operação</h3>
               <praxis-dynamic-form
-                [formId]="'bulk-params-form'"
+                [formId]="getParametersFormId()"
                 [schemaUrl]="parametersSchemaUrl()!"
                 [initialValue]="parametersValue()"
                 [resourcePath]="data.resourcePath"
@@ -791,7 +800,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
             <div class="praxis-bulk-dialog__section">
               <h3 class="praxis-bulk-dialog__section-title">Parâmetros da Operação</h3>
               <praxis-dynamic-form
-                [formId]="'bulk-params-form'"
+                [formId]="getParametersFormId()"
                 [schemaUrl]="parametersSchemaUrl()!"
                 [initialValue]="parametersValue()"
                 [resourcePath]="data.resourcePath"
@@ -8560,6 +8569,35 @@ class PraxisCrudComponent {
             toolbar.filters.enabled = true;
             changed = true;
         }
+        const existingAdvancedFilters = cfg.behavior?.filtering?.advancedFilters;
+        const hasConfiguredFilterFields = (existingAdvancedFilters?.settings?.alwaysVisibleFields?.length ?? 0) > 0 ||
+            (existingAdvancedFilters?.settings?.selectedFieldIds?.length ?? 0) > 0;
+        if (hasConfiguredFilterFields &&
+            cfg.behavior?.filtering?.enabled !== false &&
+            existingAdvancedFilters?.enabled !== false) {
+            const filtering = cfg.behavior.filtering;
+            if (filtering.enabled !== true) {
+                filtering.enabled = true;
+                changed = true;
+            }
+            if (existingAdvancedFilters.enabled !== true) {
+                existingAdvancedFilters.enabled = true;
+                changed = true;
+            }
+            const toolbar = ensureToolbar();
+            if (toolbar.visible === undefined) {
+                toolbar.visible = true;
+                changed = true;
+            }
+            if (!toolbar.filters) {
+                toolbar.filters = { enabled: true, showAdvancedButton: true };
+                changed = true;
+            }
+            else if (toolbar.filters.enabled === undefined) {
+                toolbar.filters.enabled = true;
+                changed = true;
+            }
+        }
         const effectiveResourcePath = meta?.resource?.schemaPath?.trim() || this.resolveResourcePath(meta);
         if (effectiveResourcePath && cfg.behavior?.filtering?.advancedFilters) {
             const advancedFilters = cfg.behavior.filtering.advancedFilters;
@@ -11814,7 +11852,7 @@ class PraxisResourcePage {
         const fromRoute = this.routeScopeBarSignal();
         if (fromRoute)
             return fromRoute;
-        // Auto-promoção declarativa a partir de metadata.table.toolbar.filters.quickFilters
+        // Auto-promoção declarativa a partir de metadata.table.toolbar.filters.quickFilters ou metadata.filterBar.quickFilters
         const metaSource = this.metadata || this.routeMetadataSignal();
         let meta = null;
         if (typeof metaSource === 'string' && metaSource.trim().startsWith('{')) {
@@ -11826,7 +11864,10 @@ class PraxisResourcePage {
         else if (metaSource && typeof metaSource === 'object') {
             meta = metaSource;
         }
-        const quickFilters = meta?.table?.toolbar?.filters?.quickFilters;
+        const quickFilters = meta?.table?.toolbar?.filters?.quickFilters ??
+            (Array.isArray(meta?.filterBar?.quickFilters)
+                ? meta.filterBar.quickFilters
+                : undefined);
         if (Array.isArray(quickFilters) && quickFilters.length > 0) {
             return {
                 items: quickFilters.map((qf) => ({
@@ -11837,6 +11878,7 @@ class PraxisResourcePage {
                     tone: qf.tone,
                     badge: qf.badge,
                     count: qf.count,
+                    isDefault: qf.isDefault,
                 })),
                 leadLabel: 'Filtro:',
                 leadIcon: 'tune',
@@ -11893,13 +11935,19 @@ class PraxisResourcePage {
         }
         // Se o ScopeBar estiver ativo no cabeçalho (seja manual ou auto-promovido),
         // suprimir os botões redundantes de quickFilters na toolbar interna da tabela
-        if (this.effectiveScopeBar() && base.table?.toolbar?.filters) {
+        if (this.effectiveScopeBar() &&
+            (base.table?.toolbar?.filters || Array.isArray(base.filterBar?.quickFilters))) {
+            const existingFilters = base.table?.toolbar?.filters;
             base.table = {
-                ...base.table,
+                ...(base.table || { columns: [] }),
                 toolbar: {
-                    ...base.table.toolbar,
+                    ...(base.table?.toolbar || {}),
                     filters: {
-                        ...base.table.toolbar.filters,
+                        enabled: existingFilters?.enabled ?? true,
+                        showAdvancedButton: existingFilters?.showAdvancedButton ??
+                            base.filterBar?.showAdvanced ??
+                            true,
+                        ...(existingFilters || {}),
                         showQuickFilters: false,
                     },
                 },
@@ -12026,10 +12074,10 @@ class PraxisResourcePage {
     }
     handleKpiCardClick(event) {
         const cardFilter = event.card.filter;
-        if (cardFilter && typeof cardFilter === 'object') {
+        if (cardFilter !== undefined && cardFilter !== null) {
             const sb = this.effectiveScopeBar();
             if (sb && sb.items) {
-                const matched = sb.items.find((item) => JSON.stringify(item.filter) === JSON.stringify(cardFilter));
+                const matched = sb.items.find((item) => this.areScopeFiltersEqual(item.filter, cardFilter));
                 if (matched) {
                     this.onScopeChange(matched);
                 }
@@ -12038,25 +12086,71 @@ class PraxisResourcePage {
         this.kpiCardClick.emit(event);
     }
     applyItemFilter(item) {
-        let filterObj = {};
-        if (item.filter && typeof item.filter === 'object') {
-            filterObj = item.filter;
+        this.activeScopeFilter.set(this.normalizeScopeFilterExpression(item.filter));
+    }
+    normalizeScopeFilterExpression(filter) {
+        if (filter && typeof filter === 'object' && !Array.isArray(filter)) {
+            return { ...filter };
         }
-        else if (typeof item.filter === 'string') {
-            const trimmed = item.filter.trim();
-            if (trimmed.startsWith('{')) {
+        if (typeof filter === 'string' && filter.trim().length > 0) {
+            const trimmed = filter.trim();
+            if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
                 try {
-                    filterObj = JSON.parse(trimmed);
+                    const parsed = JSON.parse(trimmed);
+                    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                        return parsed;
+                    }
                 }
                 catch {
-                    filterObj = { query: trimmed };
+                    // fallback to key-value or query below
                 }
             }
-            else if (trimmed) {
-                filterObj = { query: trimmed };
+            if (trimmed.includes('=')) {
+                const result = {};
+                const pairs = trimmed.split('&');
+                for (const pair of pairs) {
+                    const eqIdx = pair.indexOf('=');
+                    if (eqIdx > 0) {
+                        const key = pair.substring(0, eqIdx).trim();
+                        const rawVal = pair.substring(eqIdx + 1).trim();
+                        const isQuoted = (rawVal.startsWith("'") && rawVal.endsWith("'")) ||
+                            (rawVal.startsWith('"') && rawVal.endsWith('"'));
+                        const val = isQuoted ? rawVal.slice(1, -1) : rawVal;
+                        if (!isQuoted && val.toLowerCase() === 'true') {
+                            result[key] = true;
+                        }
+                        else if (!isQuoted && val.toLowerCase() === 'false') {
+                            result[key] = false;
+                        }
+                        else if (!isQuoted && /^-?\d+$/.test(val)) {
+                            result[key] = parseInt(val, 10);
+                        }
+                        else if (!isQuoted && /^-?\d+\.\d+$/.test(val)) {
+                            result[key] = parseFloat(val);
+                        }
+                        else {
+                            result[key] = val;
+                        }
+                    }
+                }
+                if (Object.keys(result).length > 0) {
+                    return result;
+                }
             }
+            return { query: trimmed };
+        }
+        return {};
+    }
+    areScopeFiltersEqual(a, b) {
+        const normA = this.normalizeScopeFilterExpression(a);
+        const normB = this.normalizeScopeFilterExpression(b);
+        const keysA = Object.keys(normA).sort();
+        const keysB = Object.keys(normB).sort();
+        if (keysA.length === 0 || keysA.length !== keysB.length) {
+            return false;
         }
-        this.activeScopeFilter.set(filterObj);
+        return keysA.every((key, idx) => key === keysB[idx] &&
+            JSON.stringify(normA[key]) === JSON.stringify(normB[key]));
     }
     extractRouteData(data) {
         if ('metadata' in data) {

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "10.0.0-rc.14",
+  "version": "10.0.0-rc.15",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/dynamic-form": "^10.0.0-rc.14",
-    "@praxisui/table": "^10.0.0-rc.14",
-    "@praxisui/core": "^10.0.0-rc.14",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.14",
-    "@praxisui/settings-panel": "^10.0.0-rc.14",
+    "@praxisui/dynamic-form": "^10.0.0-rc.15",
+    "@praxisui/table": "^10.0.0-rc.15",
+    "@praxisui/core": "^10.0.0-rc.15",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.15",
+    "@praxisui/settings-panel": "^10.0.0-rc.15",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.14",
+    "@praxisui/ai": "^10.0.0-rc.15",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud.d.ts

@@ -1135,6 +1135,8 @@ declare class PraxisResourcePage implements OnInit, OnChanges, OnDestroy {
         data: any;
     }): void;
     private applyItemFilter;
+    private normalizeScopeFilterExpression;
+    private areScopeFiltersEqual;
     private extractRouteData;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisResourcePage, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisResourcePage, "praxis-resource-page", never, { "resource": { "alias": "resource"; "required": false; }; "resourcePath": { "alias": "resourcePath"; "required": false; }; "crudId": { "alias": "crudId"; "required": false; }; "metadata": { "alias": "metadata"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "domain": { "alias": "domain"; "required": false; }; "scopeBar": { "alias": "scopeBar"; "required": false; }; "scopeItems": { "alias": "scopeItems"; "required": false; }; "defaultScopeId": { "alias": "defaultScopeId"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "tableConfigPersistenceStrategy": { "alias": "tableConfigPersistenceStrategy"; "required": false; }; "context": { "alias": "context"; "required": false; }; "actions": { "alias": "actions"; "required": false; }; "filterCriteria": { "alias": "filterCriteria"; "required": false; }; }, { "rowClick": "rowClick"; "rowAction": "rowAction"; "rowDoubleClick": "rowDoubleClick"; "selectionChange": "selectionChange"; "drawerOpen": "drawerOpen"; "drawerClose": "drawerClose"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "kpiCardClick": "kpiCardClick"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; }, never, ["[page-header-actions]"], true, never>;
@@ -1178,6 +1180,7 @@ declare class PraxisBulkOperationDialogComponent implements OnInit {
     ngOnInit(): void;
     hasParametersSchema(): boolean;
     parametersSchemaUrl(): string | null;
+    getParametersFormId(): string;
     onParametersChange(event: any): void;
     isBlockedByAtomicity(): boolean;
     isConfirmDisabled(): boolean;