@praxisui/crud 9.0.0-beta.7 → 9.0.0-beta.71

package/fesm2022/praxisui-crud.mjs

@@ -1,15 +1,16 @@
 import * as i0 from '@angular/core';
-import { Injectable, InjectionToken, inject, input, signal, computed, effect, ChangeDetectionStrategy, Component, EventEmitter, DestroyRef, ChangeDetectorRef, Injector, ViewChild, Output, Input, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { Injectable, InjectionToken, inject, input, signal, computed, effect, ChangeDetectionStrategy, Component, EventEmitter, DestroyRef, ChangeDetectorRef, Injector, ViewChild, Output, Input, Inject, ViewEncapsulation, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { HttpClient } from '@angular/common/http';
 import { Router, ActivatedRoute, RouterLink } from '@angular/router';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { firstValueFrom, BehaviorSubject, Subscription } from 'rxjs';
 import * as i2$1 from '@praxisui/core';
-import { ASYNC_CONFIG_STORAGE, GlobalConfigService, CrudOperationResolutionService, fillUndefined, SETTINGS_PANEL_DATA, PraxisI18nService, PraxisIconDirective, providePraxisI18nConfig, createDefaultTableConfig, GLOBAL_SURFACE_SERVICE, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, translateUnavailableWorkflowMessage, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
+import { ASYNC_CONFIG_STORAGE, GlobalConfigService, CrudOperationResolutionService, fillUndefined, SETTINGS_PANEL_DATA, PraxisI18nService, PraxisIconDirective, providePraxisI18nConfig, createDefaultTableConfig, GLOBAL_SURFACE_SERVICE, SurfaceOutletRegistryService, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, translateUnavailableWorkflowMessage, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
 import { SettingsPanelService } from '@praxisui/settings-panel';
 import { PraxisTableInlineAuthoringEditorComponent, PraxisTable } from '@praxisui/table';
 import { ConfirmDialogComponent } from '@praxisui/dynamic-fields';
+import { take, filter } from 'rxjs/operators';
 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';
@@ -34,7 +35,6 @@ import { MatSlideToggleModule } from '@angular/material/slide-toggle';
 import * as i10 from '@angular/material/tabs';
 import { MatTabsModule } from '@angular/material/tabs';
 import { PraxisDynamicForm } from '@praxisui/dynamic-form';
-import { filter, take } from 'rxjs/operators';
 
 class DialogService {
     matDialog;
@@ -68,6 +68,35 @@ function getCrudDrawerAdapterToken() {
 }
 const CRUD_DRAWER_ADAPTER = getCrudDrawerAdapterToken();
 
+const DEFAULT_CRUD_DRAWER_MODAL_CONFIG = {
+    minWidth: 'min(100vw, 520px)',
+    width: 'min(760px, 58vw)',
+    height: '100dvh',
+    maxWidth: '100vw',
+    maxHeight: '100dvh',
+    position: { right: '0', top: '0' },
+};
+function isCrudDebugEnabled$1() {
+    try {
+        if (globalThis.__PRAXIS_DEBUG_CRUD__) {
+            return true;
+        }
+        if (typeof localStorage !== 'undefined') {
+            return localStorage.getItem('praxis.debug.crud') === 'true';
+        }
+    }
+    catch { }
+    return false;
+}
+function debugCrudLauncher(message, ...data) {
+    if (!isCrudDebugEnabled$1()) {
+        return;
+    }
+    try {
+        console.debug(message, ...data);
+    }
+    catch { }
+}
 class CrudLauncherService {
     router = inject(Router);
     dialog = inject(DialogService);
@@ -85,8 +114,9 @@ class CrudLauncherService {
     async launch(action, row, metadata, componentKeyId, drawerCallbacks, runtime) {
         // Carregar overrides de CRUD (se houver) e mesclar em uma cópia local
         const merged = await this.mergeCrudOverrides(metadata, action, componentKeyId || undefined);
+        merged.action = this.normalizeActionForLaunch(merged.action);
         const mode = this.resolveOpenMode(merged.action, merged.metadata);
-        console.debug('[CRUD:Launcher] mode=', mode, 'action=', action);
+        debugCrudLauncher('[CRUD:Launcher] mode=', mode, 'action=', action);
         if (mode === 'route') {
             if (!merged.action.route) {
                 throw new Error(`Route not provided for action ${merged.action.action}`);
@@ -95,22 +125,6 @@ class CrudLauncherService {
             await this.router.navigateByUrl(url);
             return { mode };
         }
-        if (mode === 'drawer' && this.drawerAdapter) {
-            const actionForLaunch = this.resolveActionForLaunch(merged.action, merged.metadata);
-            const inputs = this.mapInputs(actionForLaunch, row, merged.metadata, runtime);
-            const idField = merged.metadata.resource?.idField ?? 'id';
-            if (row && inputs[idField] === undefined && row[idField] !== undefined) {
-                inputs[idField] = row[idField];
-            }
-            await Promise.resolve(this.drawerAdapter.open({
-                action: actionForLaunch,
-                metadata: merged.metadata,
-                inputs,
-                onClose: drawerCallbacks?.onClose,
-                onResult: drawerCallbacks?.onResult,
-            }));
-            return { mode };
-        }
         const actionForLaunch = this.resolveActionForLaunch(merged.action, merged.metadata);
         if (!actionForLaunch.formId) {
             throw new Error(`formId not provided for action ${actionForLaunch.action}`);
@@ -123,18 +137,26 @@ class CrudLauncherService {
             row[idField] !== undefined) {
             inputs[idField] = row[idField];
         }
+        if (mode === 'drawer' && this.drawerAdapter) {
+            await Promise.resolve(this.drawerAdapter.open({
+                action: actionForLaunch,
+                metadata: merged.metadata,
+                inputs,
+                onClose: drawerCallbacks?.onClose,
+                onResult: drawerCallbacks?.onResult,
+            }));
+            return { mode };
+        }
         const modalCfg = { ...(merged.metadata.defaults?.modal || {}) };
-        console.debug('[CRUD:Launcher] opening dialog with:', {
+        debugCrudLauncher('[CRUD:Launcher] opening dialog with:', {
             action: merged.action.action,
             formId: actionForLaunch.formId,
             inputs,
             modalCfg,
             resourcePath: merged.metadata.resource?.path ?? merged.metadata.table?.resourcePath,
         });
-        const panelClasses = ['pfx-dialog-pane', 'pfx-dialog-frosted'];
-        if (modalCfg.panelClass) {
-            panelClasses.push(modalCfg.panelClass);
-        }
+        const drawerMode = mode === 'drawer';
+        const panelClasses = mergeClassList(['pfx-dialog-pane', drawerMode ? 'pfx-drawer-pane' : 'pfx-dialog-frosted'], modalCfg.panelClass);
         // Backdrop style presets
         const backdropClasses = [];
         const style = modalCfg.backdropStyle;
@@ -147,20 +169,56 @@ class CrudLauncherService {
         else if (style === 'transparent') {
             backdropClasses.push('pfx-transparent-backdrop');
         }
-        if (modalCfg.backdropClass) {
-            backdropClasses.push(modalCfg.backdropClass);
-        }
+        const mergedBackdropClasses = mergeClassList(backdropClasses, modalCfg.backdropClass);
         const ref = await this.dialog.openAsync(() => Promise.resolve().then(function () { return dynamicFormDialogHost_component; }).then((m) => m.DynamicFormDialogHostComponent), {
             ...modalCfg,
             panelClass: panelClasses,
-            backdropClass: backdropClasses,
+            backdropClass: mergedBackdropClasses,
             autoFocus: modalCfg.autoFocus ?? true,
             restoreFocus: modalCfg.restoreFocus ?? true,
-            minWidth: '360px',
-            maxWidth: '95vw',
+            minWidth: drawerMode
+                ? (modalCfg.minWidth ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.minWidth)
+                : '360px',
+            width: drawerMode
+                ? (modalCfg.width ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.width)
+                : modalCfg.width,
+            height: drawerMode
+                ? (modalCfg.height ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.height)
+                : modalCfg.height,
+            maxWidth: drawerMode
+                ? (modalCfg.maxWidth ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.maxWidth)
+                : '95vw',
+            maxHeight: drawerMode
+                ? (modalCfg.maxHeight ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.maxHeight)
+                : modalCfg.maxHeight,
+            position: drawerMode
+                ? (modalCfg.position ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.position)
+                : modalCfg.position,
             ariaLabelledBy: 'crudDialogTitle',
-            data: { action: actionForLaunch, row, metadata: merged.metadata, inputs },
+            data: {
+                action: actionForLaunch,
+                row,
+                metadata: merged.metadata,
+                inputs,
+                presentation: drawerMode ? 'drawer' : 'modal',
+            },
         });
+        if (drawerMode) {
+            ref
+                .afterClosed()
+                .pipe(take(1))
+                .subscribe((closedValue) => {
+                const result = toCrudDrawerResult(closedValue);
+                drawerCallbacks?.onClose?.();
+                if (result?.type) {
+                    drawerCallbacks?.onResult?.(result);
+                }
+                else {
+                    drawerCallbacks?.onResult?.({ type: 'close' });
+                }
+            });
+            return { mode, ref };
+        }
         return { mode, ref };
     }
     resolveOpenMode(action, metadata) {
@@ -248,6 +306,9 @@ class CrudLauncherService {
         if (resolved.apiUrlEntry != null) {
             inputs['apiUrlEntry'] = resolved.apiUrlEntry;
         }
+        if (resolved.layoutPolicy != null) {
+            inputs['layoutPolicy'] = resolved.layoutPolicy;
+        }
         if (action.form?.initialValue != null) {
             inputs['initialValue'] = action.form.initialValue;
         }
@@ -257,6 +318,7 @@ class CrudLauncherService {
         return inputs;
     }
     resolveActionForLaunch(action, metadata) {
+        action = this.normalizeActionForLaunch(action);
         if (action.formId) {
             return action;
         }
@@ -264,29 +326,61 @@ class CrudLauncherService {
             return action;
         }
         const formId = this.buildInferredFormId(action, metadata);
-        return formId ? { ...action, formId } : action;
+        return formId
+            ? {
+                ...action,
+                formId,
+                form: {
+                    ...(action.form || {}),
+                    layoutPolicy: action.form?.layoutPolicy ?? this.defaultInferredLayoutPolicy(action),
+                },
+            }
+            : action;
+    }
+    resolveSubmitUrlTemplate(submitUrl, row, metadata) {
+        const template = String(submitUrl || '').trim();
+        if (!template || !template.includes('{')) {
+            return template;
+        }
+        const idField = String(metadata.resource?.idField ?? 'id');
+        const rowId = row?.[idField];
+        if (rowId == null) {
+            return template;
+        }
+        const encodedId = encodeURIComponent(String(rowId));
+        const idFieldPattern = new RegExp(`\\{${escapeRegExp(idField)}\\}`, 'g');
+        return template
+            .replace(idFieldPattern, encodedId)
+            .replace(/\{id\}/g, encodedId)
+            .replace(/\{resourceId\}/g, encodedId);
     }
     resolveActionFormContract(action, row, metadata, runtime) {
         if (this.isExplicitCrudAction(action)) {
             return {
                 schemaUrl: action.form?.schemaUrl ?? null,
-                submitUrl: action.form?.submitUrl ?? null,
+                submitUrl: action.form?.submitUrl
+                    ? this.resolveSubmitUrlTemplate(action.form.submitUrl, row, metadata)
+                    : null,
                 submitMethod: action.form?.submitMethod ?? null,
                 apiEndpointKey: action.form?.apiEndpointKey ?? null,
                 apiUrlEntry: action.form?.apiUrlEntry ?? null,
+                layoutPolicy: action.form?.layoutPolicy ?? null,
             };
         }
         if (!this.isCanonicalCrudAction(action.action)) {
             return {
                 apiEndpointKey: action.form?.apiEndpointKey ?? null,
                 apiUrlEntry: action.form?.apiUrlEntry ?? null,
+                layoutPolicy: action.form?.layoutPolicy ?? null,
             };
         }
         const resourcePath = String(metadata.resource?.path ?? metadata.table?.resourcePath ?? '').trim();
+        const schemaResourcePath = String(metadata.resource?.schemaPath || '').trim() || null;
         if (!resourcePath) {
             return {
                 apiEndpointKey: action.form?.apiEndpointKey ?? null,
                 apiUrlEntry: action.form?.apiUrlEntry ?? null,
+                layoutPolicy: action.form?.layoutPolicy ?? null,
             };
         }
         const idField = String(metadata.resource?.idField ?? 'id');
@@ -294,6 +388,7 @@ class CrudLauncherService {
         const resolved = this.operationResolver.resolve({
             operation: action.action,
             resourcePath,
+            schemaResourcePath,
             resourceId: resourceId ?? null,
             capabilities: runtime?.capabilities ?? null,
             links: runtime?.links ?? null,
@@ -301,14 +396,15 @@ class CrudLauncherService {
             endpointKey: action.form?.apiEndpointKey ??
                 metadata.resource?.endpointKey ??
                 undefined,
-            apiUrlEntry: action.form?.apiUrlEntry ?? null,
+            apiUrlEntry: action.form?.apiUrlEntry ?? metadata.resource?.apiUrlEntry ?? null,
         });
         return {
             schemaUrl: resolved?.schemaUrl ?? null,
             submitUrl: resolved?.submitUrl ?? null,
             submitMethod: resolved?.submitMethod ?? null,
             apiEndpointKey: action.form?.apiEndpointKey ?? metadata.resource?.endpointKey ?? null,
-            apiUrlEntry: action.form?.apiUrlEntry ?? null,
+            apiUrlEntry: action.form?.apiUrlEntry ?? metadata.resource?.apiUrlEntry ?? null,
+            layoutPolicy: action.form?.layoutPolicy ?? null,
         };
     }
     resolveRuntimeContract(action, row, metadata, runtime) {
@@ -327,9 +423,20 @@ class CrudLauncherService {
         return `${sanitizedResource || 'crud'}-${String(action.action || '').trim().toLowerCase()}`;
     }
     isCanonicalCrudAction(actionName) {
-        const normalized = String(actionName || '').trim().toLowerCase();
+        const normalized = this.normalizeCrudOperationName(actionName);
         return normalized === 'create' || normalized === 'view' || normalized === 'edit' || normalized === 'delete';
     }
+    normalizeActionForLaunch(action) {
+        const normalized = this.normalizeCrudOperationName(action.action);
+        return normalized === action.action ? action : { ...action, action: normalized };
+    }
+    normalizeCrudOperationName(actionName) {
+        const normalized = String(actionName || '').trim().toLowerCase();
+        if (['add', 'novo', 'new', 'incluir', 'inserir'].includes(normalized)) {
+            return 'create';
+        }
+        return normalized;
+    }
     isExplicitCrudAction(action) {
         if (action.mode === 'explicit') {
             return true;
@@ -338,6 +445,19 @@ class CrudLauncherService {
             String(action.form?.submitUrl || '').trim() ||
             String(action.form?.submitMethod || '').trim());
     }
+    defaultInferredLayoutPolicy(action) {
+        const operation = this.normalizeCrudOperationName(action.action);
+        if (operation !== 'create' && operation !== 'edit') {
+            return null;
+        }
+        return {
+            source: 'schema',
+            intent: 'command',
+            preset: 'groupedCommand',
+            persistence: 'transient',
+            schemaType: 'request',
+        };
+    }
     async mergeCrudOverrides(metadata, action, componentKeyId) {
         try {
             if (!componentKeyId)
@@ -392,6 +512,33 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
+function mergeClassList(base, extra) {
+    if (!extra) {
+        return base;
+    }
+    if (typeof extra === 'string') {
+        return [...base, extra];
+    }
+    if (Array.isArray(extra)) {
+        return [...base, ...extra];
+    }
+    return [
+        ...base,
+        ...Object.keys(extra).filter((className) => !!extra[className]),
+    ];
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function toCrudDrawerResult(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const result = value;
+    return result.type === 'save' || result.type === 'delete' || result.type === 'close'
+        ? result
+        : undefined;
+}
 
 const DOCUMENT_KIND = 'praxis.crud.editor';
 const DOCUMENT_VERSION = 1;
@@ -510,10 +657,15 @@ function normalizeCrudMetadata(metadata) {
     if (base.resource && typeof base.resource === 'object') {
         normalized.resource = stripUndefinedShallow({
             path: trimString(base.resource.path) || undefined,
+            schemaPath: trimString(base.resource.schemaPath) || undefined,
             idField: typeof base.resource.idField === 'string'
                 ? trimString(base.resource.idField) || undefined
                 : base.resource.idField,
+            title: trimString(base.resource.title) || undefined,
+            label: trimString(base.resource.label) || undefined,
+            formTitle: trimString(base.resource.formTitle) || undefined,
             endpointKey: trimString(base.resource.endpointKey) || undefined,
+            apiUrlEntry: base.resource.apiUrlEntry || undefined,
         });
     }
     if (base.defaults && typeof base.defaults === 'object') {
@@ -564,6 +716,7 @@ function normalizeCrudAction(action) {
                 apiEndpointKey: trimString(action.form.apiEndpointKey) || undefined,
                 apiUrlEntry: action.form.apiUrlEntry || undefined,
                 initialValue: normalizeInitialValue(action.form.initialValue),
+                layoutPolicy: action.form.layoutPolicy ?? undefined,
             }
             : undefined,
     });
@@ -3498,6 +3651,7 @@ class PraxisCrudComponent {
     resourceDiscoveryInstance;
     actionOpenAdapterInstance;
     surfaceOpenAdapterInstance;
+    materializedRefreshSequence = 0;
     global = (() => {
         try {
             return inject(GlobalConfigService);
@@ -3507,6 +3661,7 @@ class PraxisCrudComponent {
         }
     })();
     surfaceService = inject(GLOBAL_SURFACE_SERVICE, { optional: true });
+    surfaceOutlets = inject(SurfaceOutletRegistryService);
     componentKeys = inject(ComponentKeyService);
     route = (() => {
         try {
@@ -3527,6 +3682,7 @@ class PraxisCrudComponent {
     collectionCapabilitiesResolvedHref = null;
     collectionCapabilitiesRequestSeq = 0;
     currentAuthoringDocument;
+    selectedRow = null;
     getResourceDiscovery() {
         const assigned = this.resourceDiscovery;
         return assigned ?? (this.resourceDiscoveryInstance ??= this.injector.get(ResourceDiscoveryService));
@@ -3553,15 +3709,32 @@ class PraxisCrudComponent {
         catch { }
     }
     onTableRowClick(event) {
+        const row = this.extractRowFromEvent(event);
+        if (row) {
+            this.selectedRow = row;
+        }
         this.rowClick.emit(event);
     }
     onTableSelectionChange(event) {
+        this.selectedRow = this.extractSelectedRowFromEvent(event);
         this.selectionChange.emit(event);
     }
+    async onBulkAction(event) {
+        const action = String(event?.action || '').trim();
+        if (!action) {
+            return;
+        }
+        const row = this.extractSelectedRowFromBulkAction(event);
+        if (row) {
+            this.selectedRow = row;
+        }
+        await this.onAction(action, row ?? undefined, event);
+    }
     ngOnChanges(changes) {
         if (!changes['metadata'] && !changes['context']) {
             return;
         }
+        this.materializedRefreshSequence += 1;
         try {
             const parsed = typeof this.metadata === 'string'
                 ? JSON.parse(this.metadata)
@@ -3595,33 +3768,41 @@ class PraxisCrudComponent {
     async onAction(action, row, runtimeEvent) {
         try {
             document.activeElement?.blur();
-            let actionMeta = this.resolvedMetadata.actions?.find((candidate) => candidate.action === action);
+            const normalizedAction = this.normalizeCrudActionName(action);
+            const contextualRow = row ?? this.resolveSelectedRowForAction(normalizedAction);
+            let actionMeta = this.resolvedMetadata.actions?.find((candidate) => this.normalizeCrudActionName(candidate.action) === normalizedAction);
+            if (!actionMeta && normalizedAction !== action) {
+                actionMeta = this.resolvedMetadata.actions?.find((candidate) => candidate.action === action);
+            }
             if (!actionMeta) {
-                const ctxAction = this.tableCrudContext?.actions?.find((candidate) => candidate.action === action);
+                const ctxAction = this.tableCrudContext?.actions?.find((candidate) => this.normalizeCrudActionName(candidate.action) === normalizedAction);
                 if (ctxAction) {
                     actionMeta = {
-                        action: ctxAction.action,
+                        action: this.normalizeCrudActionName(ctxAction.action),
                         openMode: ctxAction.openMode,
                         formId: ctxAction.formId,
                         route: ctxAction.route,
                     };
                 }
                 else {
-                    actionMeta = { action };
+                    actionMeta = { action: normalizedAction };
                 }
             }
-            const effectiveAction = (actionMeta || { action });
+            const effectiveAction = {
+                ...(actionMeta || { action: normalizedAction }),
+                action: this.normalizeCrudActionName(actionMeta?.action ?? normalizedAction),
+            };
             if (!this.hasExplicitOpenBinding(effectiveAction)) {
-                const openedByDiscovery = await this.tryOpenDiscoveredCrudSurface(action, row, runtimeEvent);
+                const openedByDiscovery = await this.tryOpenDiscoveredCrudSurface(effectiveAction.action, contextualRow, runtimeEvent);
                 if (openedByDiscovery) {
                     return;
                 }
-                const handledByWorkflowAction = await this.tryOpenDiscoveredWorkflowAction(action, row, runtimeEvent);
+                const handledByWorkflowAction = await this.tryOpenDiscoveredWorkflowAction(effectiveAction.action, contextualRow, runtimeEvent);
                 if (handledByWorkflowAction) {
                     return;
                 }
             }
-            const handledByDelete = await this.tryHandleCanonicalDeleteAction(effectiveAction, row);
+            const handledByDelete = await this.tryHandleCanonicalDeleteAction(effectiveAction, contextualRow);
             if (handledByDelete) {
                 return;
             }
@@ -3632,7 +3813,7 @@ class PraxisCrudComponent {
                 drawerCloseEmitted = true;
                 this.afterClose.emit();
             };
-            const { mode, ref } = await this.launcher.launch(effectiveAction, row, this.resolvedMetadata, this.componentKeyId(), {
+            const { mode, ref } = await this.launcher.launch(effectiveAction, contextualRow, this.resolvedMetadata, this.componentKeyId(), {
                 onClose: () => emitDrawerClose(),
                 onResult: (result) => {
                     emitDrawerClose();
@@ -3653,9 +3834,12 @@ class PraxisCrudComponent {
                 capabilities: effectiveAction.action === 'create'
                     ? this.collectionCapabilities
                     : this.collectionCapabilities,
-                links: this.resolveCrudRuntimeLinks(effectiveAction.action, row),
+                links: this.resolveCrudRuntimeLinks(effectiveAction.action, contextualRow),
             });
             this.afterOpen.emit({ mode, action: effectiveAction.action });
+            if (mode === 'drawer') {
+                return;
+            }
             if (!ref) {
                 return;
             }
@@ -3842,8 +4026,77 @@ class PraxisCrudComponent {
         return true;
     }
     refreshTable() {
+        if (this.tryRefreshMaterializedLocalData()) {
+            return;
+        }
         this.table.refetch();
     }
+    tryRefreshMaterializedLocalData() {
+        const readUrl = this.resolveMaterializedReadUrl();
+        if (!readUrl || this.resolveResourcePath(this.resolvedMetadata)) {
+            return false;
+        }
+        const refreshSequence = ++this.materializedRefreshSequence;
+        void firstValueFrom(this.getResourceDiscovery().fetchJson(readUrl, {
+            endpointKey: this.resolvedMetadata.resource?.endpointKey,
+            apiUrlEntry: this.resolvedMetadata.resource?.apiUrlEntry,
+        }))
+            .then((response) => {
+            if (!this.isCurrentMaterializedRefresh(refreshSequence, readUrl)) {
+                return;
+            }
+            const data = this.extractCollectionData(this.unwrapRestData(response));
+            if (!data) {
+                this.error.emit({
+                    code: 'CRUD_MATERIALIZED_REFRESH_INVALID_COLLECTION',
+                    readUrl,
+                });
+                return;
+            }
+            this.resolvedMetadata = {
+                ...this.resolvedMetadata,
+                data,
+            };
+            this.applyResolvedCrudState(this.resolvedMetadata);
+            this.cdr.markForCheck();
+        })
+            .catch((error) => this.error.emit(error));
+        return true;
+    }
+    isCurrentMaterializedRefresh(refreshSequence, readUrl) {
+        return (refreshSequence === this.materializedRefreshSequence &&
+            this.resolveMaterializedReadUrl() === readUrl &&
+            this.resolveResourcePath(this.resolvedMetadata).length === 0);
+    }
+    resolveMaterializedReadUrl() {
+        const materialization = this.context?.['materialization'];
+        return String(materialization?.['readUrl'] || '').trim();
+    }
+    unwrapRestData(value) {
+        if (value && typeof value === 'object' && !Array.isArray(value) && 'data' in value) {
+            return value.data;
+        }
+        return value;
+    }
+    extractCollectionData(data) {
+        if (Array.isArray(data)) {
+            return data;
+        }
+        if (!data || typeof data !== 'object') {
+            return null;
+        }
+        const record = data;
+        if (Array.isArray(record['content'])) {
+            return record['content'];
+        }
+        if (Array.isArray(record['items'])) {
+            return record['items'];
+        }
+        if (Array.isArray(record['data'])) {
+            return record['data'];
+        }
+        return null;
+    }
     emitTableRuntimeConfigSnapshot() {
         const snapshot = this.getCurrentTableConfigSnapshot();
         if (!snapshot)
@@ -3901,11 +4154,47 @@ class PraxisCrudComponent {
         }
     }
     resolveQueryContext(meta) {
+        if (Array.isArray(meta?.data) && this.resolveResourcePath(meta).length === 0) {
+            return null;
+        }
         return this.isRecord(meta?.queryContext) ? meta.queryContext : null;
     }
     resolveFilterCriteria(meta) {
         return this.isRecord(meta?.filterCriteria) ? { ...meta.filterCriteria } : {};
     }
+    extractRowFromEvent(event) {
+        if (!this.isRecord(event)) {
+            return null;
+        }
+        const row = event['row'];
+        return this.isRecord(row) ? row : null;
+    }
+    extractSelectedRowFromEvent(event) {
+        if (!this.isRecord(event)) {
+            return null;
+        }
+        const selection = event['selection'];
+        if (Array.isArray(selection)) {
+            const first = selection[0];
+            return this.isRecord(first) ? first : null;
+        }
+        const row = event['row'];
+        if (this.isRecord(row)) {
+            return row;
+        }
+        return null;
+    }
+    extractSelectedRowFromBulkAction(event) {
+        const first = Array.isArray(event?.rows) ? event.rows[0] : null;
+        return this.isRecord(first) ? first : null;
+    }
+    resolveSelectedRowForAction(action) {
+        const normalized = String(action || '').trim().toLowerCase();
+        if (!normalized || normalized === 'create' || normalized === 'add' || normalized === 'new') {
+            return undefined;
+        }
+        return this.selectedRow ?? undefined;
+    }
     async tryOpenDiscoveredCrudSurface(action, row, runtimeEvent) {
         const normalizedAction = String(action || '').trim().toLowerCase();
         if (!this.surfaceService) {
@@ -3942,7 +4231,7 @@ class PraxisCrudComponent {
         }
         let openPromise;
         try {
-            openPromise = Promise.resolve(this.surfaceService.open(payload, {
+            const surfaceContext = {
                 sourceId: this.componentKeyId() || undefined,
                 payload: { action: normalizedAction, row: row ?? null },
                 meta: {
@@ -3959,7 +4248,9 @@ class PraxisCrudComponent {
                         resourcePath,
                     },
                 },
-            }));
+            };
+            const handledInline = await this.surfaceOutlets.tryActivate(payload, surfaceContext);
+            openPromise = handledInline ? Promise.resolve(undefined) : Promise.resolve(this.surfaceService.open(payload, surfaceContext));
         }
         catch {
             return false;
@@ -3999,7 +4290,7 @@ class PraxisCrudComponent {
         const providedAction = this.resolveProvidedWorkflowAction(normalizedAction, runtimeEvent?.actionConfig);
         const catalog = providedAction ? null : await this.resolveDiscoveredActionCatalog(row);
         const discoveredAction = providedAction || this.selectDiscoveredWorkflowAction(normalizedAction, catalog?.actions || []);
-        const resourcePath = String(this.resolveResourcePath(this.resolvedMetadata) || catalog?.resourcePath || '').trim();
+        const resourcePath = String(catalog?.resourcePath || this.resolveResourcePath(this.resolvedMetadata) || '').trim();
         if (!discoveredAction || !resourcePath) {
             return false;
         }
@@ -4222,12 +4513,19 @@ class PraxisCrudComponent {
             }
             return cfg.toolbar;
         };
-        const hasToolbarAdd = (cfg.toolbar?.actions || []).some((action) => this.isAddLike(action));
+        const hasToolbarAdd = (cfg.toolbar?.actions || []).some((action) => this.shouldCanonicalizeToolbarCreateAction(action));
         const addAction = this.resolveCreateToolbarAction(meta, capabilities);
         if (addAction) {
             if (hasToolbarAdd) {
                 const toolbar = ensureToolbar();
                 toolbar.visible = true;
+                toolbar.actions = (toolbar.actions || []).map((action) => this.shouldCanonicalizeToolbarCreateAction(action)
+                    ? {
+                        ...action,
+                        action: 'create',
+                    }
+                    : action);
+                changed = true;
             }
             else {
                 const toolbar = ensureToolbar();
@@ -4362,6 +4660,28 @@ class PraxisCrudComponent {
         }
         return false;
     }
+    normalizeCrudActionName(action) {
+        const raw = String(action || '').trim();
+        const normalized = raw.toLowerCase();
+        return this.isCreateActionAliasName(normalized) ? 'create' : raw;
+    }
+    shouldCanonicalizeToolbarCreateAction(action) {
+        if (!action)
+            return false;
+        const normalize = (value) => String(value || '').trim().toLowerCase();
+        const explicitId = normalize(action.action || action.id || action.code || action.key || action.name || action.type);
+        if (this.isCreateActionAliasName(explicitId))
+            return true;
+        if (explicitId)
+            return false;
+        const icon = normalize(action.icon);
+        const label = normalize(action.label);
+        return ((icon === 'add' || icon === 'add_circle' || icon === 'add_box') &&
+            (label === 'adicionar' || label === 'novo' || label === 'criar' || label === 'incluir'));
+    }
+    isCreateActionAliasName(actionName) {
+        return ['create', 'add', 'novo', 'new', 'incluir', 'inserir'].includes(actionName);
+    }
     buildTableCrudContext(meta, capabilities) {
         if (!meta)
             return undefined;
@@ -4642,6 +4962,7 @@ class PraxisCrudComponent {
         (selectionChange)="onTableSelectionChange($event)"
         (rowAction)="onAction($event.action, $event.row, $event)"
         (toolbarAction)="onAction($event.action)"
+        (bulkAction)="onBulkAction($event)"
         (collectionLinksChange)="onCollectionLinksChange($event)"
         (reset)="onResetPreferences()"
         (metadataChange)="onTableMetadataChange()"
@@ -4657,7 +4978,7 @@ class PraxisCrudComponent {
         />
       }
     }
-  `, isInline: true, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}\n"], dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "data", "tableId", "componentInstanceId", "configPersistenceStrategy", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "aiContext", "aiAssistantVoiceInputMode", "aiAssistantVoiceLanguage", "horizontalScroll", "enableCustomization", "dense"], outputs: ["rowClick", "widgetEvent", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "exportAction", "columnReorder", "columnReorderAttempt", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "configChange", "metadataChange", "loadingStateChange", "collectionLinksChange", "selectionChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone"] }] });
+  `, isInline: true, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}\n"], dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "data", "tableId", "componentInstanceId", "configPersistenceStrategy", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "aiContext", "aiAssistantVoiceInputMode", "aiAssistantVoiceLanguage", "horizontalScroll", "enableCustomization", "dense"], outputs: ["rowClick", "widgetEvent", "resourceEvent", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "exportAction", "columnReorder", "columnReorderAttempt", "columnResize", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "configChange", "metadataChange", "loadingStateChange", "collectionLinksChange", "selectionChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone", "variant", "alignment", "density", "iconContainer"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisCrudComponent, decorators: [{
             type: Component,
@@ -4679,6 +5000,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         (selectionChange)="onTableSelectionChange($event)"
         (rowAction)="onAction($event.action, $event.row, $event)"
         (toolbarAction)="onAction($event.action)"
+        (bulkAction)="onBulkAction($event)"
         (collectionLinksChange)="onCollectionLinksChange($event)"
         (reset)="onResetPreferences()"
         (metadataChange)="onTableMetadataChange()"
@@ -4734,6 +5056,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 args: [PraxisTable]
             }] } });
 
+function isCrudDebugEnabled() {
+    try {
+        if (globalThis.__PRAXIS_DEBUG_CRUD__) {
+            return true;
+        }
+        if (typeof localStorage !== 'undefined') {
+            return localStorage.getItem('praxis.debug.crud') === 'true';
+        }
+    }
+    catch { }
+    return false;
+}
+function debugCrudHost(message, data) {
+    if (!isCrudDebugEnabled()) {
+        return;
+    }
+    try {
+        console.debug(message, data);
+    }
+    catch { }
+}
 class DynamicFormDialogHostComponent {
     dialogRef;
     data;
@@ -4742,6 +5085,7 @@ class DynamicFormDialogHostComponent {
     configStorage;
     formComp;
     modal = {};
+    presentation = 'modal';
     maximized = false;
     initialSize = {};
     rememberState = false;
@@ -4756,7 +5100,10 @@ class DynamicFormDialogHostComponent {
     submitMethod;
     apiEndpointKey;
     apiUrlEntry;
+    layoutPolicy;
+    formConfig = {};
     formActions;
+    formConfigPersistenceStrategy = 'input-first';
     mode = 'create';
     backConfig;
     idField = 'id';
@@ -4778,6 +5125,7 @@ class DynamicFormDialogHostComponent {
         this.crud = crud;
         this.configStorage = configStorage;
         this.dialogRef.disableClose = true;
+        this.presentation = this.data.presentation === 'drawer' ? 'drawer' : 'modal';
         // i18n
         this.texts = {
             ...this.texts,
@@ -4812,12 +5160,14 @@ class DynamicFormDialogHostComponent {
         this.apiUrlEntry = this.data.inputs?.['apiUrlEntry'] ?? null;
         const act = this.data.action?.action;
         this.mode = act === 'edit' ? 'edit' : act === 'view' ? 'view' : 'create';
+        this.formConfig = this.resolveFormConfig();
+        this.layoutPolicy = this.resolveLayoutPolicy();
         this.formActions = this.resolveFormActions();
         // Back config: defaults from metadata/action, overridden by saved per-form config
         const defaults = (this.data.action?.back || this.data.metadata?.defaults?.back) || {};
         this.backDefaults = defaults;
         this.backConfig = { ...defaults };
-        console.debug('[CRUD:Host] constructed', {
+        debugCrudHost('[CRUD:Host] constructed', {
             action: this.data?.action,
             resourcePath: this.resourcePath,
             resourceId: this.resourceId,
@@ -4857,6 +5207,7 @@ class DynamicFormDialogHostComponent {
             'apiEndpointKey',
             'apiUrlEntry',
             'initialValue',
+            'layoutPolicy',
         ]);
         const explicit = inputs['initialValue'] && typeof inputs['initialValue'] === 'object'
             ? { ...inputs['initialValue'] }
@@ -4869,10 +5220,50 @@ class DynamicFormDialogHostComponent {
         }
         return Object.keys(explicit).length ? explicit : null;
     }
+    resolveFormConfig() {
+        const config = this.data.metadata?.form;
+        return config && typeof config === 'object' ? config : {};
+    }
+    get dialogTitle() {
+        const actionLabel = this.resolveActionDialogTitle();
+        return actionLabel ||
+            stringOrUndefined(this.formConfig['title']) ||
+            deriveModeTitle(this.mode, this.resolveResourceTitle()) ||
+            this.texts.title;
+    }
+    resolveActionDialogTitle() {
+        const actionLabel = stringOrUndefined(this.data.action?.label);
+        if (!actionLabel) {
+            return undefined;
+        }
+        const resource = this.data.metadata?.resource ?? {};
+        const table = this.data.metadata?.table ?? {};
+        const businessTitle = stringOrUndefined(resource.formTitle ??
+            resource.title ??
+            resource.label ??
+            table.title ??
+            table.label);
+        const routeFallbackTitle = deriveModeTitle(this.mode, titleFromResourcePath(this.resourcePath));
+        return businessTitle && routeFallbackTitle && sameTitle(actionLabel, routeFallbackTitle)
+            ? undefined
+            : actionLabel;
+    }
+    resolveResourceTitle() {
+        const resource = this.data.metadata?.resource ?? {};
+        const table = this.data.metadata?.table ?? {};
+        return stringOrUndefined(resource.formTitle ??
+            resource.title ??
+            resource.label ??
+            table.title ??
+            table.label) || titleFromResourcePath(this.resourcePath);
+    }
     resolveFormActions() {
         if (this.mode === 'view') {
             return undefined;
         }
+        if (this.formConfig?.actions) {
+            return undefined;
+        }
         const submitLabel = this.resolveSubmitLabel();
         if (!submitLabel) {
             return undefined;
@@ -4890,6 +5281,15 @@ class DynamicFormDialogHostComponent {
             },
         };
     }
+    resolveLayoutPolicy() {
+        const explicit = this.data.inputs?.['layoutPolicy'] ??
+            this.data.action?.form?.layoutPolicy ??
+            this.data.action?.layoutPolicy;
+        if (explicit && typeof explicit === 'object') {
+            return explicit;
+        }
+        return null;
+    }
     resolveSubmitLabel() {
         const action = this.data.action ?? {};
         const explicit = stringOrUndefined(action.form?.submitLabel ??
@@ -4962,10 +5362,10 @@ class DynamicFormDialogHostComponent {
             ref
                 .afterClosed()
                 .pipe(filter((confirmed) => !!confirmed), takeUntilDestroyed(this.destroyRef))
-                .subscribe(() => this.dialogRef.close());
+                .subscribe(() => this.dialogRef.close({ type: 'close' }));
         }
         else {
-            this.dialogRef.close();
+            this.dialogRef.close({ type: 'close' });
         }
     }
     toggleMaximize(initial = false) {
@@ -5008,7 +5408,7 @@ class DynamicFormDialogHostComponent {
             width: saved?.width ?? this.modal.width,
             height: saved?.height ?? this.modal.height,
         };
-        console.debug('[CRUD:Host] ngOnInit', {
+        debugCrudHost('[CRUD:Host] ngOnInit', {
             initialSize: this.initialSize,
             startMaximized: this.modal.startMaximized,
             fullscreenBreakpoint: this.modal.fullscreenBreakpoint,
@@ -5032,10 +5432,10 @@ class DynamicFormDialogHostComponent {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicFormDialogHostComponent, deps: [{ token: MatDialogRef }, { token: MAT_DIALOG_DATA }, { token: DialogService }, { token: i2$1.GenericCrudService }, { token: ASYNC_CONFIG_STORAGE }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", 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: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: DynamicFormDialogHostComponent, isStandalone: true, selector: "praxis-dynamic-form-dialog-host", host: { properties: { "attr.data-density": "modal.density || \"default\"", "attr.data-presentation": "presentation", "class.praxis-drawer": "presentation === \"drawer\"" }, 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 }}
+        {{ dialogTitle }}
       </h2>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
@@ -5069,11 +5469,14 @@ class DynamicFormDialogHostComponent {
         [resourceId]="resourceId"
         [initialValue]="initialValue"
         [mode]="mode"
+        [config]="formConfig"
         [schemaUrl]="schemaUrl"
         [submitUrl]="submitUrl"
         [submitMethod]="submitMethod"
         [apiEndpointKey]="apiEndpointKey"
         [apiUrlEntry]="apiUrlEntry"
+        [configPersistenceStrategy]="formConfigPersistenceStrategy"
+        [layoutPolicy]="layoutPolicy"
         [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
         [actions]="formActions"
@@ -5081,7 +5484,7 @@ class DynamicFormDialogHostComponent {
         (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);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: 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: i2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i6.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", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "showAiAssistant", "formId", "componentInstanceId", "configPersistenceStrategy", "layout", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "domainRules", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "configPatchChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError", "ruleDiagnosticsChange"] }] });
+  `, isInline: true, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .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)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 64px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{border-radius:0!important}\n"], dependencies: [{ 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: i2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i6.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", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "showAiAssistant", "formId", "componentInstanceId", "configPersistenceStrategy", "layout", "generatedLayoutPreset", "layoutPolicy", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "fieldIconPolicy", "domainRules", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "configPatchChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError", "ruleDiagnosticsChange"] }], encapsulation: i0.ViewEncapsulation.None });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicFormDialogHostComponent, decorators: [{
             type: Component,
@@ -5091,13 +5494,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         MatIconModule,
                         PraxisIconDirective,
                         PraxisDynamicForm
-                    ], providers: [GenericCrudService], host: {
+                    ], encapsulation: ViewEncapsulation.None, providers: [GenericCrudService], host: {
                         class: 'praxis-dialog',
                         '[attr.data-density]': 'modal.density || "default"',
+                        '[attr.data-presentation]': 'presentation',
+                        '[class.praxis-drawer]': 'presentation === "drawer"',
                     }, template: `
     <div mat-dialog-title class="dialog-header">
       <h2 id="crudDialogTitle" class="dialog-title">
-        {{ data.action?.label || texts.title }}
+        {{ dialogTitle }}
       </h2>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
@@ -5131,11 +5536,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         [resourceId]="resourceId"
         [initialValue]="initialValue"
         [mode]="mode"
+        [config]="formConfig"
         [schemaUrl]="schemaUrl"
         [submitUrl]="submitUrl"
         [submitMethod]="submitMethod"
         [apiEndpointKey]="apiEndpointKey"
         [apiUrlEntry]="apiUrlEntry"
+        [configPersistenceStrategy]="formConfigPersistenceStrategy"
+        [layoutPolicy]="layoutPolicy"
         [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
         [actions]="formActions"
@@ -5143,7 +5551,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         (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);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"] }]
+  `, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .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)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 64px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{border-radius:0!important}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MatDialogRef]
@@ -5170,6 +5578,17 @@ function stringOrUndefined(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
 }
+function sameTitle(left, right) {
+    return normalizeTitle(left) === normalizeTitle(right);
+}
+function normalizeTitle(value) {
+    return value
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLocaleLowerCase('pt-BR');
+}
 function deriveCreateSubmitLabel(actionLabel) {
     if (!actionLabel) {
         return 'Criar';
@@ -5180,6 +5599,61 @@ function deriveCreateSubmitLabel(actionLabel) {
     }
     return actionLabel;
 }
+function deriveModeTitle(mode, resourceTitle) {
+    if (!resourceTitle) {
+        return undefined;
+    }
+    const singular = lowerFirstLetter(singularizePtBrResourceTitle(resourceTitle));
+    if (mode === 'create') {
+        return `Adicionar ${singular}`;
+    }
+    if (mode === 'edit') {
+        return `Editar ${singular}`;
+    }
+    return `Visualizar ${singular}`;
+}
+function titleFromResourcePath(resourcePath) {
+    const lastSegment = resourcePath?.split('/').filter(Boolean).pop();
+    if (!lastSegment) {
+        return undefined;
+    }
+    return lastSegment
+        .replace(/[-_]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLocaleLowerCase('pt-BR');
+}
+function singularizePtBrResourceTitle(title) {
+    const normalized = title.trim();
+    const lower = normalized.toLocaleLowerCase('pt-BR');
+    if (lower === 'códigos de frequência' || lower === 'codigos de frequencia') {
+        return 'código de frequência';
+    }
+    const [first, ...rest] = normalized.split(/\s+/);
+    const singularFirst = singularizePtBrWord(first);
+    return [singularFirst, ...rest].join(' ');
+}
+function singularizePtBrWord(word) {
+    if (/ões$/i.test(word)) {
+        return word.replace(/ões$/i, 'ão');
+    }
+    if (/ais$/i.test(word)) {
+        return word.replace(/ais$/i, 'al');
+    }
+    if (/eis$/i.test(word)) {
+        return word.replace(/eis$/i, 'el');
+    }
+    if (/res$/i.test(word)) {
+        return word.replace(/es$/i, '');
+    }
+    if (/s$/i.test(word) && !/ss$/i.test(word)) {
+        return word.replace(/s$/i, '');
+    }
+    return word;
+}
+function lowerFirstLetter(value) {
+    return value.replace(/\p{L}/u, (letter) => letter.toLocaleLowerCase('pt-BR'));
+}
 
 var dynamicFormDialogHost_component = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -5325,11 +5799,31 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             type: 'PraxisDataQueryContext | null',
             description: 'Contexto semântico de consulta encaminhado para a tabela interna do CRUD. Preferir este contrato para novo authoring remoto.',
         },
+        {
+            name: 'metadata.resource.schemaPath',
+            type: 'string | null',
+            description: 'Template canonico opcional usado apenas para resolver /schemas/filtered quando resource.path precisa ser um alvo operacional concreto.',
+        },
+        {
+            name: 'metadata.resource.title',
+            type: 'string | null',
+            description: 'Titulo documental do recurso usado pelo shell CRUD para derivar titulos contextuais de criacao, edicao e visualizacao quando a action nao informa label.',
+        },
+        {
+            name: 'metadata.resource.formTitle',
+            type: 'string | null',
+            description: 'Titulo documental especifico para formularios do recurso, usado antes de metadata.resource.title no shell modal/drawer.',
+        },
         {
             name: 'metadata.filterCriteria',
             type: 'Record<string, unknown> | null',
             description: 'Bridge declarativa de filtros encaminhada para a tabela interna. Para novo authoring, prefira metadata.queryContext.',
         },
+        {
+            name: 'metadata.form',
+            type: 'FormConfig',
+            description: 'Configuração do formulário encaminhada para o PraxisDynamicForm aberto por ações modal/drawer; layout, fieldMetadata, actions e helpPresentation permanecem propriedade do Dynamic Form.',
+        },
         {
             name: 'metadata.actions[].form',
             type: 'CrudActionFormContract',
@@ -5699,6 +6193,7 @@ const CRUD_AI_CAPABILITIES = {
         { 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[].form.initialValue', category: 'actions', valueKind: 'object', description: 'Seed fixo do formulario injetado em inputs.initialValue antes da abertura.' },
+        { path: 'actions[].form.layoutPolicy', category: 'actions', valueKind: 'object', description: 'Politica schema-driven opt-in encaminhada ao Dynamic Form para materializar detalhe ou command form sem FormConfig.sections local; deve acompanhar schemaUrl compativel, especialmente schemaType=request para comandos.' },
         { path: 'actions[].back', category: 'navigation', valueKind: 'object', description: 'BackConfig por acao.' },
         { path: 'actions[].back.strategy', category: 'navigation', valueKind: 'enum', allowedValues: ENUMS.backStrategy, description: 'Estrategia de retorno da acao (auto, close, navigate).' },
         { path: 'actions[].back.returnTo', category: 'navigation', valueKind: 'string', description: 'Rota ou destino usado quando a estrategia de retorno for navigate.' },
@@ -5736,6 +6231,7 @@ const surfaceConfigureSchema = {
                 submitMethod: { enum: ['post', 'put', 'patch', 'delete'] },
                 apiEndpointKey: { type: 'string' },
                 initialValue: { type: 'object' },
+                layoutPolicy: { type: 'object' },
             },
         },
         params: {
@@ -5854,14 +6350,14 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { name: 'afterDelete', type: '{ id: string | number }', description: 'Emitted after delete; CRUD refetches the list.' },
     ],
     editableTargets: [
-        { kind: 'resourceBinding', resolver: 'crud-resource-by-path-or-key', description: 'Resource path/key, id field, endpoint key and query context owned by CRUD orchestration.' },
+        { kind: 'resourceBinding', resolver: 'crud-resource-by-path-or-key', description: 'Resource path/key, optional schema path template, id field, endpoint key and query context owned by CRUD orchestration.' },
         { kind: 'listSurface', resolver: 'crud-list-surface', description: 'CRUD-hosted list surface and table delegation boundary.' },
         { kind: 'createSurface', resolver: 'crud-action-by-id:create', description: 'Create action open mode, route/form binding and launcher inputs.' },
         { kind: 'editSurface', resolver: 'crud-action-by-id:edit', description: 'Edit action open mode, route/form binding and launcher inputs.' },
         { kind: 'viewSurface', resolver: 'crud-action-by-id:view', description: 'View action open mode, route/form binding and launcher inputs.' },
         { kind: 'deleteBehavior', resolver: 'crud-action-by-id:delete', description: 'Delete action enablement, confirmation, endpoint and capability policy.' },
-        { kind: 'dialogHost', resolver: 'crud-dialog-host-defaults', description: 'Route/modal/drawer defaults consumed by CrudLauncherService and DynamicFormDialogHostComponent.' },
-        { kind: 'formBinding', resolver: 'crud-action-form-contract-by-action-id', description: 'CRUD-owned form binding fields: formId, schemaUrl, submitUrl, submitMethod, params and initialValue.' },
+        { kind: 'dialogHost', resolver: 'crud-dialog-host-defaults', description: 'Route/modal/drawer defaults consumed by CrudLauncherService and DynamicFormDialogHostComponent, including contextual shell titles derived from action label, form title or resource metadata.' },
+        { kind: 'formBinding', resolver: 'crud-action-form-contract-by-action-id', description: 'CRUD-owned form binding fields: formId, schemaUrl, submitUrl, submitMethod, params and initialValue. Shared FormConfig remains owned by Dynamic Form and is forwarded through CrudMetadata.form when present.' },
         { kind: 'permissions', resolver: 'crud-resource-capabilities', description: 'CRUD action availability derived from resource capabilities and action permissions.' },
         { kind: 'domainGovernanceContext', resolver: 'domain-catalog-context-by-resource-key', description: 'Read-only semantic/governance context resolved from Domain Catalog and referenced from CRUD queryContext.meta.' },
         { kind: 'childOperation', resolver: 'child-authoring-manifest-operation', description: 'Delegated form/table/dialog/settings-panel operation owned by the child component manifest.' },
@@ -5877,13 +6373,13 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
             effects: [{ kind: 'compile-domain-patch', handler: 'crud-resource-bind', handlerContract: {
                         reads: ['CrudMetadata.resource', 'api_metadata', 'ResourceDiscoveryService', 'GET /{resource}/capabilities'],
                         writes: ['CrudMetadata.resource', 'CrudMetadata.queryContext', 'PraxisCrudComponent.tableCrudContext'],
-                        identityKeys: ['resourcePath', 'resourceKey'],
+                        identityKeys: ['resourcePath', 'resourceKey', 'schemaPath'],
                         inputSchema: resourceBindSchema,
                         failureModes: ['resource-not-found', 'schema-url-not-canonical', 'capabilities-unavailable', 'id-field-missing'],
-                        description: 'Binds CRUD to a canonical resource and validates it against api_metadata/resource capabilities before runtime use.',
+                        description: 'Binds CRUD to a canonical resource and validates it against api_metadata/resource capabilities before runtime use. Use CrudMetadata.resource.schemaPath when schema discovery must use a templated path while resource.path targets a concrete nested collection.',
                     } }],
             validators: ['resource-exists-in-api-metadata', 'resource-path-canonical', 'resource-key-stable', 'id-field-known', 'resource-capabilities-resolvable'],
-            affectedPaths: ['resource.path', 'resource.idField', 'resource.endpointKey', 'queryContext', 'filterCriteria'],
+            affectedPaths: ['resource.path', 'resource.schemaPath', 'resource.idField', 'resource.endpointKey', 'resource.apiUrlEntry', 'queryContext', 'filterCriteria'],
             submissionImpact: 'affects-remote-binding',
             preconditions: ['crud-metadata-loaded', 'api-metadata-available'],
         },
@@ -6017,14 +6513,14 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
             target: { kind: 'dialogHost', resolver: 'crud-dialog-host-defaults', ambiguityPolicy: 'fail', required: true },
             inputSchema: dialogHostSchema,
             effects: [{ kind: 'compile-domain-patch', handler: 'crud-dialog-host-set', handlerContract: {
-                        reads: ['CrudMetadata.defaults', 'CrudLauncherService.resolveOpenMode', 'DialogService', 'CRUD_DRAWER_ADAPTER'],
+                        reads: ['CrudMetadata.defaults', 'CrudLauncherService.resolveOpenMode', 'DialogService', 'DynamicFormDialogHostComponent', 'CRUD_DRAWER_ADAPTER'],
                         writes: ['CrudMetadata.defaults.openMode', 'CrudMetadata.defaults.modal', 'CrudMetadata.defaults.back'],
                         identityKeys: ['crudId'],
                         inputSchema: dialogHostSchema,
-                        failureModes: ['open-mode-unsupported', 'drawer-adapter-missing', 'modal-size-invalid', 'back-policy-invalid'],
-                        description: 'Configures CRUD-owned route/modal/drawer defaults consumed by the launcher and dialog host.',
+                        failureModes: ['open-mode-unsupported', 'drawer-runtime-unavailable', 'modal-size-invalid', 'back-policy-invalid'],
+                        description: 'Configures CRUD-owned route/modal/drawer defaults consumed by the launcher, default dialog-backed drawer runtime and optional host drawer adapter.',
                     } }],
-            validators: ['open-mode-supported', 'modal-size-valid', 'drawer-adapter-available-when-needed', 'back-policy-valid', 'settings-panel-shell-compatible'],
+            validators: ['open-mode-supported', 'modal-size-valid', 'drawer-runtime-available', 'back-policy-valid', 'settings-panel-shell-compatible'],
             affectedPaths: ['defaults.openMode', 'defaults.modal', 'defaults.back'],
             submissionImpact: 'config-only',
             preconditions: ['crud-metadata-loaded'],
@@ -6100,7 +6596,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { validatorId: 'permissions-delete-valid', level: 'error', code: 'CRUD_DELETE_PERMISSION_VALID', description: 'Delete permission cannot bypass resource capabilities or confirmation policy.' },
         { validatorId: 'open-mode-supported', level: 'error', code: 'CRUD_OPEN_MODE_SUPPORTED', description: 'Open mode must be route, modal or drawer.' },
         { validatorId: 'modal-size-valid', level: 'error', code: 'CRUD_MODAL_SIZE_VALID', description: 'Modal sizing defaults must be valid DialogConfig values.' },
-        { validatorId: 'drawer-adapter-available-when-needed', level: 'error', code: 'CRUD_DRAWER_ADAPTER_AVAILABLE', description: 'Drawer open mode requires a host-provided drawer adapter.' },
+        { validatorId: 'drawer-runtime-available', level: 'error', code: 'CRUD_DRAWER_RUNTIME_AVAILABLE', description: 'Drawer open mode uses the default dialog-backed drawer runtime with CRUD-owned chrome, responsive right-panel sizing, Escape/backdrop handling and semantic close/save results; a host drawer adapter is optional only for shell-specific presentation.' },
         { validatorId: 'back-policy-valid', level: 'error', code: 'CRUD_BACK_POLICY_VALID', description: 'Back policy must be valid for route/modal/drawer behavior.' },
         { validatorId: 'settings-panel-shell-compatible', level: 'warning', code: 'CRUD_SETTINGS_PANEL_COMPATIBLE', description: 'Authoring shell must preserve apply/save/reset semantics.' },
         { validatorId: 'action-permission-supported', level: 'error', code: 'CRUD_ACTION_PERMISSION_SUPPORTED', description: 'Action permissions must map to supported resource capabilities.' },