@praxisui/crud 1.0.0-beta.5 → 1.0.0-beta.52

package/fesm2022/praxisui-crud.mjs

@@ -1,12 +1,13 @@
 import * as i0 from '@angular/core';
-import { Injectable, InjectionToken, inject, EventEmitter, ViewChild, Output, Input, Component, DestroyRef, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { Injectable, InjectionToken, inject, EventEmitter, DestroyRef, ViewChild, Output, Input, Component, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { Router, ActivatedRoute, RouterLink } from '@angular/router';
 import { PraxisTable } from '@praxisui/table';
-import { Router, RouterLink } from '@angular/router';
+import { firstValueFrom } from 'rxjs';
 import * as i1 from '@angular/material/dialog';
 import { MatDialogRef, MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 export { MAT_DIALOG_DATA as DIALOG_DATA } from '@angular/material/dialog';
 import * as i2 from '@praxisui/core';
-import { CONFIG_STORAGE, GlobalConfigService, fillUndefined, EmptyStateCardComponent, PraxisIconDirective, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
+import { ASYNC_CONFIG_STORAGE, GlobalConfigService, fillUndefined, createDefaultTableConfig, ComponentKeyService, EmptyStateCardComponent, PraxisIconDirective, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import * as i1$1 from '@angular/common';
@@ -17,7 +18,7 @@ import * as i5 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
 import { PraxisDynamicForm } from '@praxisui/dynamic-form';
 import { ConfirmDialogComponent } from '@praxisui/dynamic-fields';
-import { filter } from 'rxjs/operators';
+import { filter, take } from 'rxjs/operators';
 
 class DialogService {
     matDialog;
@@ -33,20 +34,28 @@ class DialogService {
         const component = await loader();
         return this.zone.run(() => this.matDialog.open(component, config));
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: DialogService, deps: [{ token: i1.MatDialog }, { token: i0.NgZone }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: DialogService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DialogService, deps: [{ token: i1.MatDialog }, { token: i0.NgZone }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DialogService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: DialogService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DialogService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [{ type: i1.MatDialog }, { type: i0.NgZone }] });
 
-const CRUD_DRAWER_ADAPTER = new InjectionToken('CRUD_DRAWER_ADAPTER');
+function getCrudDrawerAdapterToken() {
+    const registryKey = '__PAX_CRUD_DRAWER_ADAPTER_TOKEN__';
+    const globalRegistry = globalThis;
+    if (!globalRegistry[registryKey]) {
+        globalRegistry[registryKey] = new InjectionToken('CRUD_DRAWER_ADAPTER');
+    }
+    return globalRegistry[registryKey];
+}
+const CRUD_DRAWER_ADAPTER = getCrudDrawerAdapterToken();
 
 class CrudLauncherService {
     router = inject(Router);
     dialog = inject(DialogService);
-    storage = inject(CONFIG_STORAGE);
+    storage = inject(ASYNC_CONFIG_STORAGE);
     global = inject(GlobalConfigService);
     drawerAdapter = (() => {
         try {
@@ -56,9 +65,9 @@ class CrudLauncherService {
             return undefined;
         }
     })();
-    async launch(action, row, metadata) {
+    async launch(action, row, metadata, componentKeyId, drawerCallbacks) {
         // Carregar overrides de CRUD (se houver) e mesclar em uma cópia local
-        const merged = this.mergeCrudOverrides(metadata, action);
+        const merged = await this.mergeCrudOverrides(metadata, action, componentKeyId || undefined);
         const mode = this.resolveOpenMode(merged.action, merged.metadata);
         console.debug('[CRUD:Launcher] mode=', mode, 'action=', action);
         if (mode === 'route') {
@@ -75,7 +84,13 @@ class CrudLauncherService {
             if (row && inputs[idField] === undefined && row[idField] !== undefined) {
                 inputs[idField] = row[idField];
             }
-            await Promise.resolve(this.drawerAdapter.open({ action: merged.action, metadata: merged.metadata, inputs }));
+            await Promise.resolve(this.drawerAdapter.open({
+                action: merged.action,
+                metadata: merged.metadata,
+                inputs,
+                onClose: drawerCallbacks?.onClose,
+                onResult: drawerCallbacks?.onResult,
+            }));
             return { mode };
         }
         if (!merged.action.formId) {
@@ -195,13 +210,18 @@ class CrudLauncherService {
         });
         return inputs;
     }
-    mergeCrudOverrides(metadata, action) {
+    async mergeCrudOverrides(metadata, action, componentKeyId) {
         try {
-            const tableId = metadata.resource?.path || metadata.table?.resourcePath || 'default';
-            const key = `crud-overrides:${tableId}`;
-            const saved = this.storage.loadConfig(key) || {};
-            const overDefaults = saved.defaults || {};
-            const overActions = saved.actions || {};
+            if (!componentKeyId)
+                return { metadata, action };
+            const key = `crud-overrides:${componentKeyId}`;
+            let saved = null;
+            try {
+                saved = await firstValueFrom(this.storage.loadConfig(key));
+            }
+            catch { }
+            const overDefaults = saved?.defaults || {};
+            const overActions = saved?.actions || {};
             // Merge defaults (shallow for defaults, shallow for modal/back)
             let mergedDefaults = {
                 ...(metadata.defaults || {}),
@@ -237,21 +257,29 @@ class CrudLauncherService {
             return { metadata, action };
         }
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: CrudLauncherService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: CrudLauncherService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: CrudLauncherService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: CrudLauncherService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: CrudLauncherService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: CrudLauncherService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
-function assertCrudMetadata(meta) {
+function assertCrudMetadata(meta, options = {}) {
+    if (meta.component !== 'praxis-crud') {
+        throw new Error('Invalid component type for CRUD metadata');
+    }
+    if (!meta.table) {
+        throw new Error('Table config not provided for CRUD metadata');
+    }
     meta.actions?.forEach((action) => {
         const mode = action.openMode ?? meta.defaults?.openMode ?? 'route';
-        if (mode === 'route' && !action.route) {
+        if (!options.allowDeferredActionBindings && mode === 'route' && !action.route) {
             throw new Error(`Route not provided for action ${action.action}`);
         }
-        if ((mode === 'modal' || mode === 'drawer') && !action.formId) {
+        if (!options.allowDeferredActionBindings &&
+            (mode === 'modal' || mode === 'drawer') &&
+            !action.formId) {
             throw new Error(`formId not provided for action ${action.action}`);
         }
         action.params?.forEach((p) => {
@@ -263,10 +291,12 @@ function assertCrudMetadata(meta) {
 }
 
 class PraxisCrudComponent {
-    /** Habilita visual de debug para alinhamento/layouot */
-    debugLayout = false;
     /** JSON inline ou chave/URL resolvida pelo MetadataResolver */
     metadata;
+    /** Identificador obrigatório do CRUD (base para tabela/formulário) */
+    crudId;
+    /** Identificador opcional para instâncias múltiplas */
+    componentInstanceId;
     context;
     /** Encaminha o modo de edição de layout para a tabela interna */
     editModeEnabled = false;
@@ -280,10 +310,27 @@ class PraxisCrudComponent {
     resolvedMetadata;
     /** Configuração efetiva da tabela com melhorias automáticas (ex.: botão Adicionar). */
     effectiveTableConfig;
+    /** Config passado ao PraxisTable — sempre definido (fallback seguro). */
+    tableConfigForBinding = createDefaultTableConfig();
     launcher = inject(CrudLauncherService);
+    destroyRef = inject(DestroyRef);
     table;
-    storage = inject(CONFIG_STORAGE);
+    storage = inject(ASYNC_CONFIG_STORAGE);
     snack = inject(MatSnackBar);
+    global = (() => { try {
+        return inject(GlobalConfigService);
+    }
+    catch {
+        return undefined;
+    } })();
+    componentKeys = inject(ComponentKeyService);
+    route = (() => { try {
+        return inject(ActivatedRoute);
+    }
+    catch {
+        return undefined;
+    } })();
+    warnedMissingId = false;
     /**
      * Stable CRUD context passed to PraxisTable.
      * Previously this was created via a getter, producing a new object each CD tick
@@ -292,9 +339,11 @@ class PraxisCrudComponent {
     tableCrudContext;
     onResetPreferences() {
         try {
-            const id = this.resolvedMetadata?.resource?.path || 'default';
-            const key = `crud-overrides:${id}`;
-            this.storage.clearConfig(key);
+            const keyId = this.componentKeyId();
+            if (!keyId)
+                return;
+            const key = `crud-overrides:${keyId}`;
+            void firstValueFrom(this.storage.clearConfig(key)).catch(() => { });
             this.snack.open('Overrides de CRUD redefinidos', undefined, { duration: 2000 });
         }
         catch { }
@@ -302,12 +351,21 @@ class PraxisCrudComponent {
     ngOnChanges(changes) {
         if (changes['metadata']) {
             try {
-                this.resolvedMetadata =
-                    typeof this.metadata === 'string'
-                        ? JSON.parse(this.metadata)
-                        : this.metadata;
-                assertCrudMetadata(this.resolvedMetadata);
+                const parsed = typeof this.metadata === 'string'
+                    ? JSON.parse(this.metadata)
+                    : this.metadata;
+                this.resolvedMetadata = parsed;
+                // Runtime metadata must stay structurally valid, but route/formId can be
+                // completed later by launcher overrides, defaults or host policy.
+                assertCrudMetadata(this.resolvedMetadata, {
+                    allowDeferredActionBindings: true,
+                });
                 this.effectiveTableConfig = this.buildEffectiveTableConfig(this.resolvedMetadata);
+                // Evitar passar undefined para [config], o que sobrescreve o default do PraxisTable
+                this.tableConfigForBinding =
+                    this.effectiveTableConfig ||
+                        (this.resolvedMetadata.table ??
+                            createDefaultTableConfig());
                 // Build a stable table context when metadata changes
                 this.tableCrudContext = this.buildTableCrudContext(this.resolvedMetadata);
             }
@@ -338,13 +396,39 @@ class PraxisCrudComponent {
                 }
             }
             const effectiveAction = (actionMeta || { action });
-            const { mode, ref } = await this.launcher.launch(effectiveAction, row, this.resolvedMetadata);
+            let drawerCloseEmitted = false;
+            const emitDrawerClose = () => {
+                if (drawerCloseEmitted)
+                    return;
+                drawerCloseEmitted = true;
+                this.afterClose.emit();
+            };
+            const { mode, ref } = await this.launcher.launch(effectiveAction, row, this.resolvedMetadata, this.componentKeyId(), {
+                onClose: () => {
+                    emitDrawerClose();
+                },
+                onResult: (result) => {
+                    emitDrawerClose();
+                    const data = (result?.data || {});
+                    const idField = this.getIdField();
+                    if (result?.type === 'save') {
+                        const id = data?.[idField];
+                        this.afterSave.emit({ id, data });
+                        this.refreshTable();
+                    }
+                    if (result?.type === 'delete') {
+                        const id = data?.[idField];
+                        this.afterDelete.emit({ id });
+                        this.refreshTable();
+                    }
+                },
+            });
             this.afterOpen.emit({ mode, action: effectiveAction.action });
             if (ref) {
                 const idField = this.getIdField();
                 ref
                     .afterClosed()
-                    .pipe(takeUntilDestroyed())
+                    .pipe(takeUntilDestroyed(this.destroyRef))
                     .subscribe((result) => {
                     this.afterClose.emit();
                     if (result?.type === 'save') {
@@ -369,6 +453,24 @@ class PraxisCrudComponent {
     refreshTable() {
         this.table.refetch();
     }
+    resolveResourcePath(meta) {
+        return (meta?.resource?.path ||
+            meta?.table?.resourcePath ||
+            '').trim();
+    }
+    resolveLocalData(meta) {
+        const localData = meta?.data;
+        return Array.isArray(localData) ? localData : null;
+    }
+    resolveTableData(meta) {
+        if (this.resolveResourcePath(meta).length > 0) {
+            return null;
+        }
+        return this.resolveLocalData(meta);
+    }
+    shouldRenderTable(meta) {
+        return this.resolveResourcePath(meta).length > 0 || Array.isArray(meta?.data);
+    }
     getIdField() {
         return this.resolvedMetadata?.resource?.idField || 'id';
     }
@@ -383,45 +485,77 @@ class PraxisCrudComponent {
      */
     buildEffectiveTableConfig(meta) {
         const base = meta.table;
-        if (!base)
-            return undefined;
-        // Clonar para evitar mutações
-        const cfg = JSON.parse(JSON.stringify(base));
+        // Clonar base ou criar default para permitir injeção de melhorias
+        const cfg = base
+            ? JSON.parse(JSON.stringify(base))
+            : createDefaultTableConfig();
+        let changed = false;
         const ensureToolbar = () => {
             if (!cfg.toolbar) {
                 cfg.toolbar = { visible: true, position: 'top' };
             }
             return cfg.toolbar;
         };
-        // Detectar se já existe ação de adicionar na toolbar
+        // 1) Toolbar: injetar ação "Adicionar" se metadata declara create/add e toolbar não tiver
         const hasToolbarAdd = (cfg.toolbar?.actions || []).some((a) => this.isAddLike(a));
-        // Procurar mapeamento de ação "adicionar/criar" nos metadados do CRUD
         const addAction = (meta.actions || []).find((a) => this.isAddLike(a));
-        // Se não houver mapeamento "add/create", não vamos injetar nada
-        if (!addAction) {
-            return hasToolbarAdd ? cfg : undefined;
+        if (addAction) {
+            if (hasToolbarAdd) {
+                const tb = ensureToolbar();
+                tb.visible = true; // garantir visibilidade
+            }
+            else {
+                const tb = ensureToolbar();
+                tb.visible = true;
+                if (!tb.actions)
+                    tb.actions = [];
+                const injected = {
+                    id: addAction.id || 'add',
+                    label: addAction.label || 'Adicionar',
+                    icon: addAction.icon || 'add',
+                    type: 'button',
+                    color: 'primary',
+                    position: 'end',
+                    action: addAction.action || 'add',
+                };
+                tb.actions.push(injected);
+            }
+            changed = true;
         }
-        // Se já existe na toolbar, apenas garantir visibilidade se necessário
-        if (hasToolbarAdd) {
-            const tb = ensureToolbar();
-            tb.visible = true;
-            return cfg;
+        // 2) Row actions automáticas (apenas quando host não definiu explicitamente)
+        const hostDefinedRow = !!(base && base.actions && base.actions.row);
+        const crudDefaults = this.global.get('crud.defaults') || {};
+        const autoRow = crudDefaults.autoRowActions !== false; // default true
+        if (!hostDefinedRow && autoRow) {
+            const acts = (meta.actions || []);
+            const hasView = acts.some((a) => String(a.action).toLowerCase() === 'view');
+            const hasEdit = acts.some((a) => String(a.action).toLowerCase() === 'edit');
+            const includeDelete = !!crudDefaults.includeDeleteInRow && acts.some((a) => String(a.action).toLowerCase() === 'delete');
+            const rowActions = [];
+            if (hasView)
+                rowActions.push({ id: 'view', label: 'Ver', icon: 'visibility', action: 'view', tooltip: 'Ver' });
+            if (hasEdit)
+                rowActions.push({ id: 'edit', label: 'Editar', icon: 'edit', action: 'edit', tooltip: 'Editar' });
+            if (includeDelete)
+                rowActions.push({ id: 'delete', label: 'Excluir', icon: 'delete', action: 'delete', tooltip: 'Excluir' });
+            if (rowActions.length) {
+                cfg.actions = cfg.actions || {};
+                cfg.actions.row = {
+                    enabled: true,
+                    position: 'end',
+                    width: cfg.actions?.row?.width || '120px',
+                    display: crudDefaults.rowActionsDisplay || 'icons',
+                    trigger: cfg.actions?.row?.trigger || 'hover',
+                    actions: rowActions,
+                    header: { label: cfg.actions?.row?.header?.label || '' },
+                };
+                changed = true;
+            }
+        }
+        // Se nada foi alterado e havia base, não retornar para preservar semântica anterior
+        if (!changed) {
+            return base ? undefined : cfg;
         }
-        // Injetar ação na toolbar
-        const tb = ensureToolbar();
-        tb.visible = true;
-        if (!tb.actions)
-            tb.actions = [];
-        const injected = {
-            id: addAction.id || 'add',
-            label: addAction.label || 'Adicionar',
-            icon: addAction.icon || 'add',
-            type: 'button',
-            color: 'primary',
-            position: 'end',
-            action: addAction.action || 'add',
-        };
-        tb.actions.push(injected);
         return cfg;
     }
     /** Heurística leve para identificar ações do tipo "adicionar/criar" */
@@ -451,8 +585,9 @@ class PraxisCrudComponent {
             ? meta.actions
             : [{ action: 'create' }, { action: 'view' }, { action: 'edit' }];
         return {
-            tableId: meta.resource?.path || meta.table?.resourcePath || 'default',
-            resourcePath: meta.resource?.path || meta.table?.resourcePath,
+            tableId: this.crudId || 'default',
+            componentKeyId: this.componentKeyId() || undefined,
+            resourcePath: this.resolveResourcePath(meta) || undefined,
             defaults: meta.defaults,
             actions: baseActions.map((a) => ({
                 action: a.action,
@@ -464,68 +599,90 @@ class PraxisCrudComponent {
             idField: meta.resource?.idField || 'id',
         };
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: PraxisCrudComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.1.4", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { debugLayout: "debugLayout", metadata: "metadata", context: "context", editModeEnabled: "editModeEnabled" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error" }, viewQueries: [{ propertyName: "table", first: true, predicate: PraxisTable, descendants: true }], usesOnChanges: true, ngImport: i0, template: `
-    @if ($any(resolvedMetadata)?.resource?.path) {
+    componentKeyId() {
+        const key = this.componentKeys.buildComponentId({
+            componentType: 'praxis-crud',
+            componentId: this.crudId,
+            instanceKey: this.componentInstanceId,
+            componentRef: this,
+            route: this.route,
+            requireComponentId: true,
+        });
+        if (!key)
+            this.warnMissingId();
+        return key;
+    }
+    warnMissingId() {
+        if (this.warnedMissingId)
+            return;
+        this.warnedMissingId = true;
+        console.warn('[PraxisCrud] crudId is required for config persistence.');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisCrudComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.17", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { metadata: "metadata", crudId: "crudId", componentInstanceId: "componentInstanceId", context: "context", editModeEnabled: "editModeEnabled" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error" }, viewQueries: [{ propertyName: "table", first: true, predicate: PraxisTable, descendants: true }], usesOnChanges: true, ngImport: i0, template: `
+    @if (shouldRenderTable(resolvedMetadata)) {
       <praxis-table
-        [config]="effectiveTableConfig || resolvedMetadata.table"
-        [resourcePath]="resolvedMetadata.resource?.path"
-        [tableId]="resolvedMetadata.resource?.path || 'default'"
+        [config]="tableConfigForBinding"
+        [resourcePath]="resolveResourcePath(resolvedMetadata)"
+        [data]="resolveTableData(resolvedMetadata)"
+        [tableId]="crudId || 'default'"
         [crudContext]="tableCrudContext"
         [editModeEnabled]="editModeEnabled"
         (rowAction)="onAction($event.action, $event.row)"
         (toolbarAction)="onAction($event.action)"
         (reset)="onResetPreferences()"
-        [debugLayout]="debugLayout"
       ></praxis-table>
     } @else {
       @if (editModeEnabled) {
         <praxis-empty-state-card
           icon="table_rows"
           [title]="'Conecte o CRUD a um recurso'"
-          [description]="'Informe os metadados (resourcePath / schema) para habilitar a tabela e ações.'"
+          [description]="'Informe os metadados (resourcePath / schema) ou forneça metadata.data para habilitar a tabela e ações.'"
           [primaryAction]="{ label: 'Configurar metadados', icon: 'bolt', action: onConfigureRequested.bind(this) }"
         />
       }
     }
-  `, isInline: true, dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "filterCriteria", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "showToolbar", "toolbarV2", "autoDelete", "editModeEnabled", "dense", "tableId", "debugLayout", "crudContext", "idField"], outputs: ["rowClick", "rowAction", "toolbarAction", "bulkAction", "rowDoubleClick", "schemaStatusChange", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline"] }] });
+  `, isInline: true, dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "data", "tableId", "componentInstanceId", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "dslFunctionRegistry", "editModeEnabled", "dense"], outputs: ["rowClick", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "columnReorder", "columnReorderAttempt", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "metadataChange", "loadingStateChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone"] }] });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: PraxisCrudComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisCrudComponent, decorators: [{
             type: Component,
             args: [{
                     selector: 'praxis-crud',
                     standalone: true,
                     imports: [PraxisTable, EmptyStateCardComponent],
                     template: `
-    @if ($any(resolvedMetadata)?.resource?.path) {
+    @if (shouldRenderTable(resolvedMetadata)) {
       <praxis-table
-        [config]="effectiveTableConfig || resolvedMetadata.table"
-        [resourcePath]="resolvedMetadata.resource?.path"
-        [tableId]="resolvedMetadata.resource?.path || 'default'"
+        [config]="tableConfigForBinding"
+        [resourcePath]="resolveResourcePath(resolvedMetadata)"
+        [data]="resolveTableData(resolvedMetadata)"
+        [tableId]="crudId || 'default'"
         [crudContext]="tableCrudContext"
         [editModeEnabled]="editModeEnabled"
         (rowAction)="onAction($event.action, $event.row)"
         (toolbarAction)="onAction($event.action)"
         (reset)="onResetPreferences()"
-        [debugLayout]="debugLayout"
       ></praxis-table>
     } @else {
       @if (editModeEnabled) {
         <praxis-empty-state-card
           icon="table_rows"
           [title]="'Conecte o CRUD a um recurso'"
-          [description]="'Informe os metadados (resourcePath / schema) para habilitar a tabela e ações.'"
+          [description]="'Informe os metadados (resourcePath / schema) ou forneça metadata.data para habilitar a tabela e ações.'"
           [primaryAction]="{ label: 'Configurar metadados', icon: 'bolt', action: onConfigureRequested.bind(this) }"
         />
       }
     }
   `,
                 }]
-        }], propDecorators: { debugLayout: [{
-                type: Input
-            }], metadata: [{
+        }], propDecorators: { metadata: [{
                 type: Input,
                 args: [{ required: true }]
+            }], crudId: [{
+                type: Input,
+                args: [{ required: true }]
+            }], componentInstanceId: [{
+                type: Input
             }], context: [{
                 type: Input
             }], editModeEnabled: [{
@@ -559,6 +716,7 @@ class DynamicFormDialogHostComponent {
     initialSize = {};
     rememberState = false;
     stateKey;
+    backDefaults = {};
     destroyRef = inject(DestroyRef);
     resourcePath;
     resourceId;
@@ -610,10 +768,8 @@ class DynamicFormDialogHostComponent {
         this.mode = act === 'edit' ? 'edit' : act === 'view' ? 'view' : 'create';
         // Back config: defaults from metadata/action, overridden by saved per-form config
         const defaults = (this.data.action?.back || this.data.metadata?.defaults?.back) || {};
-        const saved = this.data.action?.formId
-            ? this.configStorage.loadConfig(`crud-back:${this.data.action.formId}`)
-            : null;
-        this.backConfig = { ...defaults, ...(saved || {}) };
+        this.backDefaults = defaults;
+        this.backConfig = { ...defaults };
         console.debug('[CRUD:Host] constructed', {
             action: this.data?.action,
             resourcePath: this.resourcePath,
@@ -644,34 +800,25 @@ class DynamicFormDialogHostComponent {
     }
     ngOnInit() {
         // Carregar estado salvo (se habilitado)
-        const saved = this.rememberState && this.stateKey
-            ? this.configStorage.loadConfig(this.stateKey)
-            : null;
-        this.initialSize = {
-            width: saved?.width ?? this.modal.width,
-            height: saved?.height ?? this.modal.height,
-        };
-        console.debug('[CRUD:Host] ngOnInit', {
-            initialSize: this.initialSize,
-            startMaximized: this.modal.startMaximized,
-            fullscreenBreakpoint: this.modal.fullscreenBreakpoint,
-        });
-        let shouldMax = false;
-        if (saved && typeof saved.maximized === 'boolean') {
-            shouldMax = !!saved.maximized;
+        if (this.rememberState && this.stateKey) {
+            this.configStorage
+                .loadConfig(this.stateKey)
+                .pipe(take(1))
+                .subscribe((saved) => this.applySavedState(saved || null));
         }
         else {
-            shouldMax =
-                this.modal.startMaximized ||
-                    (this.modal.fullscreenBreakpoint &&
-                        window.innerWidth <= this.modal.fullscreenBreakpoint);
+            this.applySavedState(null);
         }
-        if (shouldMax) {
-            this.toggleMaximize(true);
-        }
-        else if (this.initialSize.width || this.initialSize.height) {
-            this.dialogRef.updateSize(this.initialSize.width, this.initialSize.height);
-            this.dialogRef.updatePosition();
+        // Carregar override de back config se houver formId
+        if (this.data.action?.formId) {
+            this.configStorage
+                .loadConfig(`crud-back:${this.data.action.formId}`)
+                .pipe(take(1))
+                .subscribe((saved) => {
+                if (saved && typeof saved === 'object') {
+                    this.backConfig = { ...this.backDefaults, ...saved };
+                }
+            });
         }
     }
     onSave(result) {
@@ -695,6 +842,7 @@ class DynamicFormDialogHostComponent {
                     cancelText: this.texts.discardCancel,
                     type: 'warning',
                 },
+                autoFocus: false,
             });
             ref
                 .afterClosed()
@@ -731,15 +879,46 @@ class DynamicFormDialogHostComponent {
         const style = pane ? getComputedStyle(pane) : null;
         const currentWidth = style?.width || this.initialSize.width;
         const currentHeight = style?.height || this.initialSize.height;
-        this.configStorage.saveConfig(this.stateKey, {
+        this.configStorage
+            .saveConfig(this.stateKey, {
             maximized: this.maximized,
             width: currentWidth,
             height: currentHeight,
+        })
+            .pipe(take(1))
+            .subscribe({ error: () => { } });
+    }
+    applySavedState(saved) {
+        this.initialSize = {
+            width: saved?.width ?? this.modal.width,
+            height: saved?.height ?? this.modal.height,
+        };
+        console.debug('[CRUD:Host] ngOnInit', {
+            initialSize: this.initialSize,
+            startMaximized: this.modal.startMaximized,
+            fullscreenBreakpoint: this.modal.fullscreenBreakpoint,
         });
+        let shouldMax = false;
+        if (saved && typeof saved.maximized === 'boolean') {
+            shouldMax = !!saved.maximized;
+        }
+        else {
+            shouldMax =
+                this.modal.startMaximized ||
+                    (this.modal.fullscreenBreakpoint &&
+                        window.innerWidth <= this.modal.fullscreenBreakpoint);
+        }
+        if (shouldMax) {
+            this.toggleMaximize(true);
+        }
+        else if (this.initialSize.width || this.initialSize.height) {
+            this.dialogRef.updateSize(this.initialSize.width, this.initialSize.height);
+            this.dialogRef.updatePosition();
+        }
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: DynamicFormDialogHostComponent, deps: [{ token: MatDialogRef }, { token: MAT_DIALOG_DATA }, { token: DialogService }, { token: i2.GenericCrudService }, { token: CONFIG_STORAGE }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.1.4", type: DynamicFormDialogHostComponent, isStandalone: true, selector: "praxis-dynamic-form-dialog-host", host: { properties: { "attr.data-density": "modal.density || \"default\"" }, classAttribute: "praxis-dialog" }, providers: [GenericCrudService], viewQueries: [{ propertyName: "formComp", first: true, predicate: PraxisDynamicForm, descendants: true }], ngImport: i0, template: `
-    <div class="dialog-header">
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DynamicFormDialogHostComponent, deps: [{ token: MatDialogRef }, { token: MAT_DIALOG_DATA }, { token: DialogService }, { token: i2.GenericCrudService }, { token: ASYNC_CONFIG_STORAGE }], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.17", type: DynamicFormDialogHostComponent, isStandalone: true, selector: "praxis-dynamic-form-dialog-host", host: { properties: { "attr.data-density": "modal.density || \"default\"" }, classAttribute: "praxis-dialog" }, providers: [GenericCrudService], viewQueries: [{ propertyName: "formComp", first: true, predicate: PraxisDynamicForm, descendants: true }], ngImport: i0, template: `
+    <div mat-dialog-title class="dialog-header">
       <h2 id="crudDialogTitle" class="dialog-title">
         {{ data.action?.label || texts.title }}
       </h2>
@@ -749,13 +928,9 @@ class DynamicFormDialogHostComponent {
           mat-icon-button
           type="button"
           (click)="toggleMaximize()"
-          [attr.aria-label]="
-            maximized ? texts.restoreLabel : texts.maximizeLabel
-          "
+          [attr.aria-label]="maximized ? texts.restoreLabel : texts.maximizeLabel"
         >
-          <mat-icon>{{
-            maximized ? 'close_fullscreen' : 'open_in_full'
-          }}</mat-icon>
+          <mat-icon [praxisIcon]="maximized ? 'close_fullscreen' : 'open_in_full'"></mat-icon>
         </button>
       }
       <button
@@ -778,14 +953,15 @@ class DynamicFormDialogHostComponent {
         [resourcePath]="resourcePath"
         [resourceId]="resourceId"
         [mode]="mode"
+        [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, isInline: true, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary),transparent 90%)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "mode", "config", "schemaSource", "editModeEnabled", "formId", "layout", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "formReady", "valueChange", "syncCompleted", "initializationError", "editModeEnabledChange", "customAction", "actionConfirmation", "schemaStatusChange"] }] });
+  `, isInline: true, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "mode", "config", "schemaSource", "editModeEnabled", "formId", "componentInstanceId", "layout", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "editModeEnabledChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError"] }] });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: DynamicFormDialogHostComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DynamicFormDialogHostComponent, decorators: [{
             type: Component,
             args: [{ selector: 'praxis-dynamic-form-dialog-host', standalone: true, imports: [
                         CommonModule,
@@ -798,7 +974,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
                         class: 'praxis-dialog',
                         '[attr.data-density]': 'modal.density || "default"',
                     }, template: `
-    <div class="dialog-header">
+    <div mat-dialog-title class="dialog-header">
       <h2 id="crudDialogTitle" class="dialog-title">
         {{ data.action?.label || texts.title }}
       </h2>
@@ -808,13 +984,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
           mat-icon-button
           type="button"
           (click)="toggleMaximize()"
-          [attr.aria-label]="
-            maximized ? texts.restoreLabel : texts.maximizeLabel
-          "
+          [attr.aria-label]="maximized ? texts.restoreLabel : texts.maximizeLabel"
         >
-          <mat-icon>{{
-            maximized ? 'close_fullscreen' : 'open_in_full'
-          }}</mat-icon>
+          <mat-icon [praxisIcon]="maximized ? 'close_fullscreen' : 'open_in_full'"></mat-icon>
         </button>
       }
       <button
@@ -837,12 +1009,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
         [resourcePath]="resourcePath"
         [resourceId]="resourceId"
         [mode]="mode"
+        [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary),transparent 90%)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"] }]
+  `, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MatDialogRef]
@@ -851,7 +1024,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
                     args: [MAT_DIALOG_DATA]
                 }] }, { type: DialogService }, { type: i2.GenericCrudService }, { type: undefined, decorators: [{
                     type: Inject,
-                    args: [CONFIG_STORAGE]
+                    args: [ASYNC_CONFIG_STORAGE]
                 }] }], propDecorators: { formComp: [{
                 type: ViewChild,
                 args: [PraxisDynamicForm]
@@ -874,12 +1047,22 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
         {
             name: 'metadata',
             type: 'CrudMetadata | string',
-            description: 'Metadados de configuração do CRUD',
+            description: 'Metadados de configuração do CRUD (fonte remota via resource.path ou local via metadata.data).',
+        },
+        {
+            name: 'crudId',
+            type: 'string',
+            description: 'Identificador do CRUD (base para tabela/formulário e persistência)',
+        },
+        {
+            name: 'componentInstanceId',
+            type: 'string',
+            description: 'Identificador opcional para múltiplas instâncias na mesma rota',
         },
         {
             name: 'context',
             type: 'Record<string, unknown>',
-            description: 'Contexto adicional para resoluções',
+            description: 'Contexto opaco do host. A implementacao atual o expõe como Input, mas nao o consome no launcher nem no tableCrudContext.',
         },
         {
             name: 'editModeEnabled',
@@ -916,6 +1099,108 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             description: 'Emitido quando CTA de configuração é acionado em modo edição',
         },
     ],
+    actions: [
+        {
+            id: 'create',
+            label: 'Criar',
+            icon: 'add',
+            description: 'Emite evento ao abrir fluxo de criação',
+            emit: 'afterOpen',
+            payloadSchema: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', description: 'Ação executada' },
+                    mode: { type: 'string', description: 'Modo de abertura' },
+                },
+                required: ['action', 'mode'],
+                example: { action: 'create', mode: 'route' },
+            },
+            scope: 'toolbar',
+        },
+        {
+            id: 'view',
+            label: 'Visualizar',
+            icon: 'visibility',
+            description: 'Emite evento ao abrir fluxo de visualização',
+            emit: 'afterOpen',
+            payloadSchema: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', description: 'Ação executada' },
+                    mode: { type: 'string', description: 'Modo de abertura' },
+                },
+                required: ['action', 'mode'],
+                example: { action: 'view', mode: 'modal' },
+            },
+            scope: 'context',
+        },
+        {
+            id: 'edit',
+            label: 'Editar',
+            icon: 'edit',
+            description: 'Emite evento ao abrir fluxo de edição',
+            emit: 'afterOpen',
+            payloadSchema: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', description: 'Ação executada' },
+                    mode: { type: 'string', description: 'Modo de abertura' },
+                },
+                required: ['action', 'mode'],
+                example: { action: 'edit', mode: 'drawer' },
+            },
+            scope: 'context',
+        },
+        {
+            id: 'delete',
+            label: 'Excluir',
+            icon: 'delete',
+            description: 'Emite evento após exclusão',
+            emit: 'afterDelete',
+            payloadSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string | number', description: 'ID do registro (string ou number)' },
+                },
+                required: ['id'],
+                example: { id: '123' },
+            },
+            scope: 'context',
+        },
+        {
+            id: 'save',
+            label: 'Salvar',
+            icon: 'save',
+            description: 'Emite evento após salvar',
+            emit: 'afterSave',
+            payloadSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string | number', description: 'ID do registro (string ou number)' },
+                    data: { type: 'object', description: 'Dados salvos' },
+                },
+                required: ['id', 'data'],
+                example: { id: '123', data: {} },
+            },
+            scope: 'shell',
+        },
+        {
+            id: 'close',
+            label: 'Fechar',
+            icon: 'close',
+            description: 'Emite evento ao fechar o diálogo',
+            emit: 'afterClose',
+            scope: 'shell',
+        },
+        {
+            id: 'configure',
+            label: 'Configurar',
+            icon: 'tune',
+            description: 'Emite evento ao abrir configuração',
+            emit: 'configureRequested',
+            scope: 'shell',
+        },
+    ],
     tags: ['widget', 'crud', 'configurable', 'hasWizard', 'stable'],
     lib: '@praxisui/crud',
 };
@@ -939,8 +1224,8 @@ class CrudPageHeaderComponent {
     sticky = true;
     divider = true;
     returnTo;
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: CrudPageHeaderComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.1.4", type: CrudPageHeaderComponent, isStandalone: true, selector: "praxis-crud-page-header", inputs: { title: "title", backLabel: "backLabel", showBack: "showBack", variant: "variant", sticky: "sticky", divider: "divider", returnTo: "returnTo" }, ngImport: i0, template: `
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: CrudPageHeaderComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: CrudPageHeaderComponent, isStandalone: true, selector: "praxis-crud-page-header", inputs: { title: "title", backLabel: "backLabel", showBack: "showBack", variant: "variant", sticky: "sticky", divider: "divider", returnTo: "returnTo" }, ngImport: i0, template: `
     <header
       class="crud-header"
       [class.sticky]="sticky"
@@ -966,9 +1251,9 @@ class CrudPageHeaderComponent {
         <ng-content></ng-content>
       </div>
     </header>
-  `, isInline: true, styles: [".crud-header{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:8px 0;background:var(--md-sys-color-surface, transparent)}.crud-header.sticky{position:sticky;top:0;z-index:10;-webkit-backdrop-filter:saturate(110%);backdrop-filter:saturate(110%)}.crud-header.with-divider{border-bottom:1px solid var(--md-sys-color-outline-variant, rgba(0,0,0,.08))}.left{display:flex;align-items:center;gap:8px;min-width:0}.right{display:flex;align-items:center;gap:8px}.title{margin:0;font-weight:600;color:var(--md-sys-color-on-surface, currentColor);font:var(--mdc-typography-title-large, 600 20px/28px system-ui);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.back-btn{display:inline-flex;align-items:center;gap:6px;text-decoration:none}.back-btn .mat-mdc-button{padding-left:0}.back-btn mat-icon{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn .label{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn.ghost{border-radius:20px;padding:4px 8px}.back-btn.ghost:hover{background:color-mix(in srgb,var(--md-sys-color-primary) 8%,transparent)}.back-btn.tonal{border-radius:20px;padding:4px 10px;background:var(--md-sys-color-surface-container, rgba(0,0,0,.02));box-shadow:inset 0 0 0 1px var(--md-sys-color-outline-variant, rgba(0,0,0,.06))}.back-btn.tonal:hover{background:color-mix(in srgb,var(--md-sys-color-primary) 10%,var(--md-sys-color-surface-container))}.back-btn.outlined{border-radius:20px;padding:4px 10px;border:1px solid var(--md-sys-color-outline-variant, rgba(0,0,0,.12));background:var(--md-sys-color-surface, transparent)}.back-btn.outlined:hover{border-color:color-mix(in srgb,var(--md-sys-color-primary) 40%,var(--md-sys-color-outline-variant));background:color-mix(in srgb,var(--md-sys-color-primary) 6%,transparent)}@media (max-width: 599px){.label.hide-on-narrow{display:none}}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "directive", type: RouterLink, selector: "[routerLink]", inputs: ["target", "queryParams", "fragment", "queryParamsHandling", "state", "info", "relativeTo", "preserveFragment", "skipLocationChange", "replaceUrl", "routerLink"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }] });
+  `, isInline: true, styles: [".crud-header{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:8px 0;background:var(--md-sys-color-surface)}.crud-header.sticky{position:sticky;top:0;z-index:10;-webkit-backdrop-filter:saturate(110%);backdrop-filter:saturate(110%)}.crud-header.with-divider{border-bottom:1px solid var(--md-sys-color-outline-variant)}.left{display:flex;align-items:center;gap:8px;min-width:0}.right{display:flex;align-items:center;gap:8px}.title{margin:0;font-weight:600;color:var(--md-sys-color-on-surface, currentColor);font:var(--mdc-typography-title-large, 600 20px/28px system-ui);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.back-btn{display:inline-flex;align-items:center;gap:6px;text-decoration:none}.back-btn .mat-mdc-button{padding-left:0}.back-btn mat-icon{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn .label{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn.ghost{border-radius:20px;padding:4px 8px}.back-btn.ghost:hover{background:var(--md-sys-color-primary-container)}.back-btn.tonal{border-radius:20px;padding:4px 10px;background:var(--md-sys-color-surface-container);box-shadow:inset 0 0 0 1px var(--md-sys-color-outline-variant)}.back-btn.tonal:hover{background:var(--md-sys-color-primary-container)}.back-btn.outlined{border-radius:20px;padding:4px 10px;border:1px solid var(--md-sys-color-outline-variant);background:var(--md-sys-color-surface)}.back-btn.outlined:hover{border-color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}@media(max-width:599px){.label.hide-on-narrow{display:none}}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "directive", type: RouterLink, selector: "[routerLink]", inputs: ["target", "queryParams", "fragment", "queryParamsHandling", "state", "info", "relativeTo", "preserveFragment", "skipLocationChange", "replaceUrl", "routerLink"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }] });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImport: i0, type: CrudPageHeaderComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: CrudPageHeaderComponent, decorators: [{
             type: Component,
             args: [{ selector: 'praxis-crud-page-header', standalone: true, imports: [CommonModule, RouterLink, MatButtonModule, MatIconModule, PraxisIconDirective], template: `
     <header
@@ -996,7 +1281,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
         <ng-content></ng-content>
       </div>
     </header>
-  `, styles: [".crud-header{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:8px 0;background:var(--md-sys-color-surface, transparent)}.crud-header.sticky{position:sticky;top:0;z-index:10;-webkit-backdrop-filter:saturate(110%);backdrop-filter:saturate(110%)}.crud-header.with-divider{border-bottom:1px solid var(--md-sys-color-outline-variant, rgba(0,0,0,.08))}.left{display:flex;align-items:center;gap:8px;min-width:0}.right{display:flex;align-items:center;gap:8px}.title{margin:0;font-weight:600;color:var(--md-sys-color-on-surface, currentColor);font:var(--mdc-typography-title-large, 600 20px/28px system-ui);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.back-btn{display:inline-flex;align-items:center;gap:6px;text-decoration:none}.back-btn .mat-mdc-button{padding-left:0}.back-btn mat-icon{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn .label{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn.ghost{border-radius:20px;padding:4px 8px}.back-btn.ghost:hover{background:color-mix(in srgb,var(--md-sys-color-primary) 8%,transparent)}.back-btn.tonal{border-radius:20px;padding:4px 10px;background:var(--md-sys-color-surface-container, rgba(0,0,0,.02));box-shadow:inset 0 0 0 1px var(--md-sys-color-outline-variant, rgba(0,0,0,.06))}.back-btn.tonal:hover{background:color-mix(in srgb,var(--md-sys-color-primary) 10%,var(--md-sys-color-surface-container))}.back-btn.outlined{border-radius:20px;padding:4px 10px;border:1px solid var(--md-sys-color-outline-variant, rgba(0,0,0,.12));background:var(--md-sys-color-surface, transparent)}.back-btn.outlined:hover{border-color:color-mix(in srgb,var(--md-sys-color-primary) 40%,var(--md-sys-color-outline-variant));background:color-mix(in srgb,var(--md-sys-color-primary) 6%,transparent)}@media (max-width: 599px){.label.hide-on-narrow{display:none}}\n"] }]
+  `, styles: [".crud-header{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:8px 0;background:var(--md-sys-color-surface)}.crud-header.sticky{position:sticky;top:0;z-index:10;-webkit-backdrop-filter:saturate(110%);backdrop-filter:saturate(110%)}.crud-header.with-divider{border-bottom:1px solid var(--md-sys-color-outline-variant)}.left{display:flex;align-items:center;gap:8px;min-width:0}.right{display:flex;align-items:center;gap:8px}.title{margin:0;font-weight:600;color:var(--md-sys-color-on-surface, currentColor);font:var(--mdc-typography-title-large, 600 20px/28px system-ui);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.back-btn{display:inline-flex;align-items:center;gap:6px;text-decoration:none}.back-btn .mat-mdc-button{padding-left:0}.back-btn mat-icon{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn .label{color:var(--md-sys-color-on-surface-variant, currentColor)}.back-btn.ghost{border-radius:20px;padding:4px 8px}.back-btn.ghost:hover{background:var(--md-sys-color-primary-container)}.back-btn.tonal{border-radius:20px;padding:4px 10px;background:var(--md-sys-color-surface-container);box-shadow:inset 0 0 0 1px var(--md-sys-color-outline-variant)}.back-btn.tonal:hover{background:var(--md-sys-color-primary-container)}.back-btn.outlined{border-radius:20px;padding:4px 10px;border:1px solid var(--md-sys-color-outline-variant);background:var(--md-sys-color-surface)}.back-btn.outlined:hover{border-color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}@media(max-width:599px){.label.hide-on-narrow{display:none}}\n"] }]
         }], propDecorators: { title: [{
                 type: Input
             }], backLabel: [{
@@ -1013,6 +1298,96 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
                 type: Input
             }] } });
 
+/**
+ * Capabilities catalog for CrudMetadata (Praxis CRUD).
+ */
+const ENUMS = {
+    openMode: ['route', 'modal', 'drawer'],
+    paramTarget: ['routeParam', 'query', 'input'],
+    headerVariant: ['ghost', 'tonal', 'outlined'],
+    toolbarActionType: ['button', 'icon', 'fab', 'menu'],
+    toolbarActionAppearance: ['filled', 'outlined', 'elevated', 'text', 'tonal'],
+    toolbarActionPosition: ['start', 'end'],
+    backStrategy: ['auto', 'close', 'navigate'],
+};
+const CRUD_AI_CAPABILITIES = {
+    version: 'v1.0',
+    enums: ENUMS,
+    targets: ['praxis-crud', 'crud-view', 'generic-crud'],
+    notes: [
+        'CrudMetadata agrega TableConfig e FormConfig; use os catalogos de tabela e formulario para detalhes.',
+        'actions[] herda campos de RowAction e ToolbarAction; combine com openMode/route/formId quando aplicavel.',
+    ],
+    capabilities: [
+        // --- Metadata root ---
+        {
+            path: 'component',
+            category: 'meta',
+            valueKind: 'enum',
+            allowedValues: ['praxis-crud'],
+            description: 'Identificador fixo do componente.',
+            critical: true,
+        },
+        // --- Resource ---
+        { path: 'resource', category: 'resource', valueKind: 'object', description: 'Recurso principal do CRUD.' },
+        { path: 'resource.path', category: 'resource', valueKind: 'string', description: 'Endpoint base do recurso.' },
+        { path: 'resource.idField', category: 'resource', valueKind: 'string', description: 'Campo identificador do recurso.' },
+        { path: 'resource.endpointKey', category: 'resource', valueKind: 'string', description: 'Chave de endpoint (ApiEndpoint).' },
+        // --- Table / Form ---
+        { path: 'table', category: 'table', valueKind: 'object', description: 'TableConfig completo (usar catalogo de tabela).' },
+        { path: 'form', category: 'form', valueKind: 'object', description: 'FormConfig completo (usar catalogo de formulario).' },
+        // --- Defaults ---
+        { path: 'defaults', category: 'defaults', valueKind: 'object', description: 'Defaults aplicados a acoes e UI.' },
+        { path: 'defaults.openMode', category: 'defaults', valueKind: 'enum', allowedValues: ENUMS.openMode, description: 'Modo padrao de abertura (route/modal/drawer).' },
+        { path: 'defaults.modal', category: 'defaults', valueKind: 'object', description: 'Config de dialog (DialogConfig).' },
+        { path: 'defaults.back', category: 'navigation', valueKind: 'object', description: 'Config de retorno (BackConfig).' },
+        { path: 'defaults.back.strategy', category: 'navigation', valueKind: 'enum', allowedValues: ENUMS.backStrategy, description: 'Estrategia de retorno.' },
+        { path: 'defaults.back.returnTo', category: 'navigation', valueKind: 'string', description: 'Rota de retorno quando strategy=navigate.' },
+        { path: 'defaults.back.confirmOnDirty', category: 'navigation', valueKind: 'boolean', description: 'Confirmar ao sair com alteracoes.' },
+        { path: 'defaults.header', category: 'defaults', valueKind: 'object', description: 'Config do header do CRUD.' },
+        { path: 'defaults.header.showBack', category: 'defaults', valueKind: 'boolean', description: 'Exibir botao voltar.' },
+        { path: 'defaults.header.backLabel', category: 'defaults', valueKind: 'string', description: 'Label do botao voltar.' },
+        { path: 'defaults.header.variant', category: 'defaults', valueKind: 'enum', allowedValues: ENUMS.headerVariant, description: 'Variante visual do header.' },
+        { path: 'defaults.header.sticky', category: 'defaults', valueKind: 'boolean', description: 'Header fixo.' },
+        { path: 'defaults.header.breadcrumbs', category: 'defaults', valueKind: 'boolean', description: 'Exibir breadcrumbs.' },
+        { path: 'defaults.header.divider', category: 'defaults', valueKind: 'boolean', description: 'Exibir divisor no header.' },
+        // --- Actions ---
+        { path: 'actions', category: 'actions', valueKind: 'array', description: 'Acoes disponiveis no CRUD.' },
+        { path: 'actions[].id', category: 'actions', valueKind: 'string', description: 'ID da acao (RowAction/ToolbarAction).' },
+        { path: 'actions[].label', category: 'actions', valueKind: 'string', description: 'Label da acao.' },
+        { path: 'actions[].icon', category: 'actions', valueKind: 'string', description: 'Icone da acao.' },
+        { path: 'actions[].color', category: 'actions', valueKind: 'string', description: 'Cor da acao.' },
+        { path: 'actions[].disabled', category: 'actions', valueKind: 'boolean', description: 'Acao desabilitada.' },
+        { path: 'actions[].action', category: 'actions', valueKind: 'string', description: 'Nome da acao emitida.' },
+        { path: 'actions[].tooltip', category: 'actions', valueKind: 'string', description: 'Tooltip da acao.' },
+        { path: 'actions[].requiresConfirmation', category: 'actions', valueKind: 'boolean', description: 'Exige confirmacao.' },
+        { path: 'actions[].visibleWhen', category: 'actions', valueKind: 'expression', description: 'Condicao de visibilidade (RowAction/ToolbarAction).' },
+        { path: 'actions[].separator', category: 'actions', valueKind: 'boolean', description: 'Separador apos a acao (RowAction).' },
+        { path: 'actions[].autoDelete', category: 'actions', valueKind: 'boolean', description: 'Habilita auto delete (RowAction).' },
+        { path: 'actions[].deleteEndpoint', category: 'actions', valueKind: 'string', description: 'Endpoint custom para delete (RowAction).' },
+        { path: 'actions[].type', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.toolbarActionType, description: 'Tipo de acao (ToolbarAction).' },
+        { path: 'actions[].appearance', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.toolbarActionAppearance, description: 'Aparencia do botao (ToolbarAction).' },
+        { path: 'actions[].position', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.toolbarActionPosition, description: 'Posicao da acao (ToolbarAction).' },
+        { path: 'actions[].order', category: 'actions', valueKind: 'number', description: 'Ordem de exibicao (ToolbarAction).' },
+        { path: 'actions[].shortcut', category: 'actions', valueKind: 'string', description: 'Atalho de teclado (ToolbarAction).' },
+        { path: 'actions[].children', category: 'actions', valueKind: 'array', description: 'Sub-acoes (menu).' },
+        { path: 'actions[].openMode', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.openMode, description: 'Modo de abertura da acao.' },
+        { path: 'actions[].route', category: 'actions', valueKind: 'string', description: 'Rota para openMode=route.' },
+        { path: 'actions[].formId', category: 'actions', valueKind: 'string', description: 'FormId canonico para modal/drawer; se ausente, o host precisa resolve-lo por override por acao antes da abertura.' },
+        { path: 'actions[].params', category: 'actions', valueKind: 'array', description: 'Mapeamento de parametros.' },
+        { path: 'actions[].params[].from', category: 'actions', valueKind: 'string', description: 'Origem do parametro.' },
+        { path: 'actions[].params[].to', category: 'actions', valueKind: 'enum', allowedValues: ENUMS.paramTarget, description: 'Destino do parametro.' },
+        { path: 'actions[].params[].name', category: 'actions', valueKind: 'string', description: 'Nome do parametro no destino.' },
+        { path: 'actions[].back', category: 'navigation', valueKind: 'object', description: 'BackConfig por acao.' },
+        { path: 'actions[].back.strategy', category: 'navigation', valueKind: 'enum', allowedValues: ENUMS.backStrategy },
+        { path: 'actions[].back.returnTo', category: 'navigation', valueKind: 'string' },
+        { path: 'actions[].back.confirmOnDirty', category: 'navigation', valueKind: 'boolean' },
+        // --- i18n ---
+        { path: 'i18n', category: 'i18n', valueKind: 'object', description: 'Mensagens i18n do CRUD.' },
+        { path: 'i18n.crudDialog', category: 'i18n', valueKind: 'object', description: 'Mapa de textos do dialog.' },
+    ],
+};
+
 /*
  * Public API Surface of praxis-crud
  */
@@ -1021,5 +1396,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.4", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { CRUD_DRAWER_ADAPTER, CrudLauncherService, CrudPageHeaderComponent, DialogService, DynamicFormDialogHostComponent, PRAXIS_CRUD_COMPONENT_METADATA, PraxisCrudComponent, assertCrudMetadata, providePraxisCrudMetadata };
+export { CRUD_AI_CAPABILITIES, CrudLauncherService, CrudPageHeaderComponent, DialogService, DynamicFormDialogHostComponent, PRAXIS_CRUD_COMPONENT_METADATA, PraxisCrudComponent, assertCrudMetadata, providePraxisCrudMetadata };
 //# sourceMappingURL=praxisui-crud.mjs.map