@praxisui/crud 9.0.4-rc.9 → 9.0.4

package/fesm2022/praxisui-crud.mjs

@@ -1,12 +1,12 @@
 import * as i0 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 { Injectable, InjectionToken, inject, input, signal, computed, effect, ChangeDetectionStrategy, Component, EventEmitter, DestroyRef, ChangeDetectorRef, Injector, ViewChild, Output, Input, Optional, 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, EnterpriseRuntimeContextService, GLOBAL_SURFACE_SERVICE, SurfaceOutletRegistryService, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, translateUnavailableWorkflowMessage, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, PraxisIconButtonComponent, PraxisResourceIdentityComponent, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
+import { ASYNC_CONFIG_STORAGE, GlobalConfigService, CrudOperationResolutionService, LoggerService, SurfaceNavigationError, fillUndefined, SETTINGS_PANEL_DATA, PraxisI18nService, PraxisIconDirective, providePraxisI18nConfig, createDefaultTableConfig, EnterpriseRuntimeContextService, GLOBAL_SURFACE_SERVICE, SurfaceOutletRegistryService, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, normalizeSurfaceOperationContext, translateUnavailableWorkflowMessage, isSurfaceNavigationError, translateSurfaceNavigationRejected, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, SURFACE_DRAWER_REF, SURFACE_DRAWER_CONTENT_DATA, PraxisIconButtonComponent, PraxisResourceIdentityComponent, GenericCrudService, ComponentMetadataRegistry } from '@praxisui/core';
 import { SettingsPanelService } from '@praxisui/settings-panel';
 import { PraxisTableInlineAuthoringEditorComponent, PraxisTable } from '@praxisui/table';
 import { ConfirmDialogComponent } from '@praxisui/dynamic-fields';
@@ -97,12 +97,44 @@ function debugCrudLauncher(message, ...data) {
     }
     catch { }
 }
+/**
+ * Captures the interaction origin before metadata, capability, or lazy-host
+ * work yields the event loop. Material can restore focus to an explicit
+ * element, which is essential when the action originated in a closing menu.
+ */
+function captureCrudActionFocusOrigin() {
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const active = document.activeElement;
+    if (!(active instanceof HTMLElement) || active === document.body || !active.isConnected) {
+        return null;
+    }
+    return active;
+}
+function isRuntimeFocusOrigin(value) {
+    return typeof HTMLElement !== 'undefined'
+        && value instanceof HTMLElement
+        && typeof value.focus === 'function';
+}
+function resolveCrudRestoreFocus(configured, actionFocusOrigin) {
+    if (configured === false || typeof configured === 'string') {
+        return configured;
+    }
+    if (typeof HTMLElement !== 'undefined' && configured instanceof HTMLElement) {
+        return configured;
+    }
+    return actionFocusOrigin ?? true;
+}
 class CrudLauncherService {
     router = inject(Router);
     dialog = inject(DialogService);
     storage = inject(ASYNC_CONFIG_STORAGE);
     global = inject(GlobalConfigService);
     operationResolver = inject(CrudOperationResolutionService);
+    logger = inject(LoggerService, { optional: true });
+    dialogHostPromise;
+    nextSurfaceFrameId = 0;
     drawerAdapter = (() => {
         try {
             return inject(CRUD_DRAWER_ADAPTER);
@@ -112,6 +144,18 @@ class CrudLauncherService {
         }
     })();
     async launch(action, row, metadata, componentKeyId, drawerCallbacks, runtime) {
+        // Capture before every await below. A toolbar/row menu closes before the
+        // form host is resolved, so the browser's later activeElement is not a
+        // reliable representation of the user-facing action trigger.
+        // A responsive host can replace the menu trigger while the menu is
+        // closing. Keep the original runtime-only reference even when detached:
+        // the overlay host resolves its stable data-praxis-focus-key on close.
+        const actionFocusOrigin = isRuntimeFocusOrigin(runtime?.focusOrigin)
+            ? runtime.focusOrigin
+            : captureCrudActionFocusOrigin();
+        const prefetchedDialogHost = this.isLikelyOverlayAction(action, metadata)
+            ? this.loadDialogHost()
+            : undefined;
         // 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);
@@ -137,21 +181,71 @@ class CrudLauncherService {
             row[idField] !== undefined) {
             inputs[idField] = row[idField];
         }
-        const resourceIdentity = actionForLaunch.action === 'edit'
+        const resourceIdentity = actionForLaunch.action === 'edit' || actionForLaunch.action === 'view'
             ? runtime?.resourceIdentity ?? null
             : null;
+        const contextIdentity = runtime?.contextIdentity ?? null;
+        const dialogData = {
+            action: actionForLaunch,
+            row,
+            metadata: merged.metadata,
+            inputs,
+            presentation: mode === 'drawer' ? 'drawer' : 'modal',
+            resourceIdentity,
+            contextIdentity,
+        };
+        const modalCfg = { ...(merged.metadata.defaults?.modal || {}) };
+        const restoreFocus = resolveCrudRestoreFocus(modalCfg.restoreFocus, actionFocusOrigin);
+        if (mode === 'drawer' && runtime?.surfaceRuntime?.push) {
+            const frameId = this.buildSurfaceFrameId(actionForLaunch);
+            const frameRef = await runtime.surfaceRuntime.push({
+                id: frameId,
+                title: this.resolveSurfaceFrameTitle(actionForLaunch, merged.metadata),
+                titleIcon: stringOrUndefined$1(actionForLaunch['icon']),
+                subtitle: this.resolveSurfaceFrameSubtitle(actionForLaunch, merged.metadata),
+                ...(actionFocusOrigin
+                    ? { returnFocusTo: actionFocusOrigin }
+                    : {}),
+                content: {
+                    component: await (prefetchedDialogHost ?? this.loadDialogHost()),
+                    inputs: { data: dialogData },
+                },
+            });
+            if (!frameRef) {
+                const error = new SurfaceNavigationError('SURFACE_SESSION_NAVIGATION_REJECTED', 'push', frameId);
+                this.logger?.warn('Surface session rejected nested CRUD frame.', {
+                    context: {
+                        lib: '@praxisui/crud',
+                        component: 'CrudLauncherService',
+                        actionId: `crud.${String(actionForLaunch.action || 'unknown')}`,
+                    },
+                    data: {
+                        code: error.code,
+                        operation: error.operation,
+                        frameId: error.frameId,
+                        formId: actionForLaunch.formId,
+                        openMode: mode,
+                    },
+                    throttleKey: `${error.code}:crud:${frameId}`,
+                });
+                throw error;
+            }
+            this.bindSurfaceFrameLifecycle(frameRef, drawerCallbacks);
+            return { mode };
+        }
         if (mode === 'drawer' && this.drawerAdapter) {
             await Promise.resolve(this.drawerAdapter.open({
                 action: actionForLaunch,
                 metadata: merged.metadata,
                 inputs,
                 resourceIdentity,
+                contextIdentity,
+                restoreFocus,
                 onClose: drawerCallbacks?.onClose,
                 onResult: drawerCallbacks?.onResult,
             }));
             return { mode };
         }
-        const modalCfg = { ...(merged.metadata.defaults?.modal || {}) };
         debugCrudLauncher('[CRUD:Launcher] opening dialog with:', {
             action: merged.action.action,
             formId: actionForLaunch.formId,
@@ -177,12 +271,12 @@ class CrudLauncherService {
             backdropClasses.push('pfx-transparent-backdrop');
         }
         const mergedBackdropClasses = mergeClassList(backdropClasses, modalCfg.backdropClass);
-        const ref = await this.dialog.openAsync(() => Promise.resolve().then(function () { return dynamicFormDialogHost_component; }).then((m) => m.DynamicFormDialogHostComponent), {
+        const ref = await this.dialog.openAsync(() => prefetchedDialogHost ?? this.loadDialogHost(), {
             ...modalCfg,
             panelClass: panelClasses,
             backdropClass: mergedBackdropClasses,
             autoFocus: modalCfg.autoFocus ?? true,
-            restoreFocus: modalCfg.restoreFocus ?? true,
+            restoreFocus,
             minWidth: drawerMode
                 ? (modalCfg.minWidth ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.minWidth)
                 : '360px',
@@ -201,13 +295,9 @@ class CrudLauncherService {
             position: dialogPosition,
             ariaLabelledBy: 'crudDialogTitle',
             data: {
-                action: actionForLaunch,
-                row,
-                metadata: merged.metadata,
-                inputs,
+                ...dialogData,
                 presentation: drawerMode ? 'drawer' : 'modal',
                 dialogPosition,
-                resourceIdentity,
             },
         });
         if (drawerMode) {
@@ -256,6 +346,13 @@ class CrudLauncherService {
             return 'route';
         }
     }
+    isLikelyOverlayAction(action, metadata) {
+        const configuredMode = action.openMode ?? metadata.defaults?.openMode;
+        return configuredMode === 'drawer' || configuredMode === 'modal';
+    }
+    loadDialogHost() {
+        return this.dialogHostPromise ??= Promise.resolve().then(function () { return dynamicFormDialogHost_component; }).then((module) => module.DynamicFormDialogHostComponent);
+    }
     buildRoute(action, row, metadata) {
         let route = action.route;
         const query = {};
@@ -468,8 +565,51 @@ class CrudLauncherService {
             preset: 'groupedCommand',
             persistence: 'transient',
             schemaType: 'request',
+            groupedCommand: {
+                partialRowStrategy: 'fill-compatible',
+            },
         };
     }
+    buildSurfaceFrameId(action) {
+        this.nextSurfaceFrameId += 1;
+        return `crud:${action.action}:${action.formId || 'form'}:${this.nextSurfaceFrameId}`;
+    }
+    resolveSurfaceFrameTitle(action, metadata) {
+        return stringOrUndefined$1(action['label'])
+            ?? stringOrUndefined$1(metadata.form?.['title'])
+            ?? stringOrUndefined$1(metadata.table?.['title'])
+            ?? (action.action === 'create'
+                ? 'Adicionar registro'
+                : action.action === 'view'
+                    ? 'Consultar registro'
+                    : 'Editar registro');
+    }
+    resolveSurfaceFrameSubtitle(action, metadata) {
+        return stringOrUndefined$1(action['description'])
+            ?? stringOrUndefined$1(action['tooltip'])
+            ?? stringOrUndefined$1(metadata.form?.['description'])
+            ?? stringOrUndefined$1(metadata.table?.['subtitle']);
+    }
+    bindSurfaceFrameLifecycle(frameRef, callbacks) {
+        let semanticResultHandled = false;
+        const handleResult = (value) => {
+            if (semanticResultHandled)
+                return;
+            const result = toCrudDrawerResult(value);
+            if (!result || result.type === 'close')
+                return;
+            semanticResultHandled = true;
+            callbacks?.onResult?.(result);
+        };
+        frameRef.result$?.pipe(take(1)).subscribe(handleResult);
+        frameRef.closed$.pipe(take(1)).subscribe((value) => {
+            handleResult(value);
+            callbacks?.onClose?.();
+            if (!semanticResultHandled) {
+                callbacks?.onResult?.({ type: 'close' });
+            }
+        });
+    }
     async mergeCrudOverrides(metadata, action, componentKeyId) {
         try {
             if (!componentKeyId)
@@ -551,6 +691,10 @@ function toCrudDrawerResult(value) {
         ? result
         : undefined;
 }
+function stringOrUndefined$1(value) {
+    const text = String(value ?? '').trim();
+    return text || undefined;
+}
 
 const DOCUMENT_KIND = 'praxis.crud.editor';
 const DOCUMENT_VERSION = 1;
@@ -888,7 +1032,7 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.emptyState.primaryAction': 'Configurar metadados',
                 'crud.table.emptyState.initial.title': 'Sem registros em {label}',
                 'crud.table.emptyState.initial.titleFallback': 'Nenhum registro disponível.',
-                'crud.table.emptyState.initial.descriptionWithAction': 'Use a ação principal para adicionar o primeiro registro quando houver informações para cadastrar.',
+                'crud.table.emptyState.initial.descriptionWithToolbarAction': 'Use "{action}" na barra da tabela para adicionar o primeiro registro quando houver informações para cadastrar.',
                 'crud.table.emptyState.filtered.title': 'Nenhum resultado encontrado.',
                 'crud.table.emptyState.filtered.description': 'Revise os filtros ou ajuste o termo de busca.',
                 'crud.preferences.resetSuccess': 'Overrides de CRUD redefinidos',
@@ -896,7 +1040,12 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.actions.view': 'Ver',
                 'crud.actions.edit': 'Editar',
                 'crud.actions.delete': 'Excluir',
+                'crud.actions.default': 'ação',
+                'crud.actions.opening': 'Abrindo {action}…',
+                'crud.surface.openFailed': 'Não foi possível abrir {title}. Tente novamente ou confirme se esse recurso continua disponível.',
                 'crud.dialog.recordContextLabel': 'Registro em edição',
+                'crud.dialog.viewRecordContextLabel': 'Registro em consulta',
+                'crud.dialog.relatedContextLabel': 'Vinculado a',
                 'crud.delete.confirmMessage': 'Esta ação não pode ser desfeita. Deseja continuar?',
                 'crud.delete.cancel': 'Cancelar',
             },
@@ -906,7 +1055,7 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.emptyState.primaryAction': 'Configure metadata',
                 'crud.table.emptyState.initial.title': 'No records in {label}',
                 'crud.table.emptyState.initial.titleFallback': 'No records available.',
-                'crud.table.emptyState.initial.descriptionWithAction': 'Use the primary action to add the first record when there is information to register.',
+                'crud.table.emptyState.initial.descriptionWithToolbarAction': 'Use "{action}" in the table toolbar to add the first record when there is information to register.',
                 'crud.table.emptyState.filtered.title': 'No results found.',
                 'crud.table.emptyState.filtered.description': 'Review the filters or adjust the search term.',
                 'crud.preferences.resetSuccess': 'CRUD overrides reset',
@@ -914,7 +1063,12 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.actions.view': 'View',
                 'crud.actions.edit': 'Edit',
                 'crud.actions.delete': 'Delete',
+                'crud.actions.default': 'action',
+                'crud.actions.opening': 'Opening {action}…',
+                'crud.surface.openFailed': 'Could not open {title}. Try again or confirm that this resource is still available.',
                 'crud.dialog.recordContextLabel': 'Record being edited',
+                'crud.dialog.viewRecordContextLabel': 'Record being viewed',
+                'crud.dialog.relatedContextLabel': 'Related to',
                 'crud.delete.confirmMessage': 'This action cannot be undone. Do you want to continue?',
                 'crud.delete.cancel': 'Cancel',
             },
@@ -3643,6 +3797,8 @@ class PraxisCrudComponent {
     metadata;
     crudId;
     componentInstanceId;
+    /** Controls whether the CRUD's internal table trusts host input or stored user configuration. */
+    tableConfigPersistenceStrategy = 'local-first';
     context;
     enableCustomization = false;
     /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
@@ -3654,6 +3810,8 @@ class PraxisCrudComponent {
     afterDelete = new EventEmitter();
     error = new EventEmitter();
     rowClick = new EventEmitter();
+    /** Emits the canonical table row-action envelope before the CRUD handles its surface/action. */
+    rowAction = new EventEmitter();
     selectionChange = new EventEmitter();
     tableRuntimeConfigChange = new EventEmitter();
     crudAuthoringDocumentApplied = new EventEmitter();
@@ -3664,6 +3822,7 @@ class PraxisCrudComponent {
     tableQueryContext = null;
     tableFilterCriteria = {};
     tableCrudContext;
+    openingActionLabel = signal(null, ...(ngDevMode ? [{ debugName: "openingActionLabel" }] : /* istanbul ignore next */ []));
     launcher = inject(CrudLauncherService);
     http = inject(HttpClient);
     destroyRef = inject(DestroyRef);
@@ -3723,6 +3882,10 @@ class PraxisCrudComponent {
     collectionCapabilitiesRequestSeq = 0;
     currentAuthoringDocument;
     selectedRow = null;
+    onTableRowAction(event) {
+        this.rowAction.emit(event);
+        void this.onAction(event.action || '', event.row, event);
+    }
     getResourceDiscovery() {
         const assigned = this.resourceDiscovery;
         return assigned ?? (this.resourceDiscoveryInstance ??= this.injector.get(ResourceDiscoveryService));
@@ -3815,8 +3978,11 @@ class PraxisCrudComponent {
         }
     }
     async onAction(action, row, runtimeEvent) {
+        if (this.openingActionLabel()) {
+            return;
+        }
+        this.openingActionLabel.set(this.resolveOpeningActionLabel(action, runtimeEvent));
         try {
-            document.activeElement?.blur();
             const normalizedAction = this.normalizeCrudActionName(action);
             const contextualRow = row ?? this.resolveSelectedRowForAction(normalizedAction);
             let actionMeta = this.resolvedMetadata.actions?.find((candidate) => this.normalizeCrudActionName(candidate.action) === normalizedAction);
@@ -3842,6 +4008,7 @@ class PraxisCrudComponent {
                 action: this.normalizeCrudActionName(actionMeta?.action ?? normalizedAction),
             };
             const resourceIdentity = runtimeEvent?.resourceIdentity ?? null;
+            const contextIdentity = this.resolveTaskScopeIdentity();
             const handledByDuplicateDraft = await this.tryHandleCanonicalDuplicateDraftAction(effectiveAction, contextualRow);
             if (handledByDuplicateDraft) {
                 return;
@@ -3890,6 +4057,9 @@ class PraxisCrudComponent {
                     : this.collectionCapabilities,
                 links: this.resolveCrudRuntimeLinks(effectiveAction.action, contextualRow),
                 resourceIdentity,
+                contextIdentity,
+                focusOrigin: runtimeEvent?.focusOrigin ?? null,
+                surfaceRuntime: this.resolveSurfaceRuntime(),
             });
             this.afterOpen.emit({ mode, action: effectiveAction.action });
             if (mode === 'drawer') {
@@ -3920,7 +4090,32 @@ class PraxisCrudComponent {
         }
         catch (err) {
             this.error.emit(err);
+            this.notifySurfaceNavigationFailure(err);
+        }
+        finally {
+            this.openingActionLabel.set(null);
+        }
+    }
+    resolveTaskScopeIdentity() {
+        const operation = normalizeSurfaceOperationContext(this.context?.['operation']);
+        return operation?.taskScope?.identity ?? null;
+    }
+    getOpeningActionStatus(actionLabel) {
+        return this.txWithParams('crud.actions.opening', 'Abrindo {action}…', { action: actionLabel });
+    }
+    resolveOpeningActionLabel(action, runtimeEvent) {
+        const configuredLabel = String(runtimeEvent?.actionConfig?.label || '').trim();
+        if (configuredLabel) {
+            return configuredLabel;
+        }
+        const normalized = this.normalizeCrudActionName(action);
+        if (normalized === 'create'
+            || normalized === 'view'
+            || normalized === 'edit'
+            || normalized === 'delete') {
+            return this.getCrudActionLabel(normalized);
         }
+        return String(action || '').trim() || this.tx('crud.actions.default', 'ação');
     }
     hasExplicitOpenBinding(action) {
         const mode = action.openMode;
@@ -4132,6 +4327,7 @@ class PraxisCrudComponent {
         }, {
             capabilities: this.collectionCapabilities,
             links: this.tableCollectionLinks,
+            surfaceRuntime: this.resolveSurfaceRuntime(),
         });
         this.afterOpen.emit({ mode, action: normalizedAction });
         if (mode !== 'drawer' && ref) {
@@ -4151,6 +4347,14 @@ class PraxisCrudComponent {
         }
         this.table.refetch();
     }
+    resolveSurfaceRuntime() {
+        const candidate = this.context?.['surfaceRuntime'];
+        if (!candidate || typeof candidate !== 'object') {
+            return null;
+        }
+        const runtime = candidate;
+        return typeof runtime.push === 'function' ? runtime : null;
+    }
     tryRefreshMaterializedLocalData() {
         const readUrl = this.resolveMaterializedReadUrl();
         if (!readUrl || this.resolveResourcePath(this.resolvedMetadata)) {
@@ -4316,6 +4520,17 @@ class PraxisCrudComponent {
         const first = Array.isArray(event?.selectedRows) ? event.selectedRows[0] : null;
         return this.isRecord(first) ? first : null;
     }
+    /**
+     * Keeps the DOM trigger exclusively in transient runtime context. Discovery
+     * payloads remain JSON-safe and can still be authored, inspected and
+     * persisted independently from the browser that opened the surface.
+     */
+    resolveRuntimeFocusOrigin(event) {
+        const focusOrigin = event?.focusOrigin;
+        return focusOrigin && typeof focusOrigin.focus === 'function'
+            ? focusOrigin
+            : undefined;
+    }
     extractDiscoveryActionConfig(event) {
         const config = event?.actionConfig;
         return this.isRecord(config) && typeof config['resourceKey'] === 'string'
@@ -4335,9 +4550,6 @@ class PraxisCrudComponent {
             return false;
         }
         const providedSurface = this.resolveProvidedSurface(normalizedAction, this.extractDiscoveryActionConfig(runtimeEvent));
-        if (!providedSurface && !this.isDiscoveryManagedCrudAction(normalizedAction)) {
-            return false;
-        }
         const catalog = providedSurface
             ? null
             : await this.resolveDiscoveredSurfaceCatalog(normalizedAction, row);
@@ -4358,11 +4570,18 @@ class PraxisCrudComponent {
                 endpointKey: this.resolvedMetadata?.resource?.endpointKey,
                 apiUrlEntry: this.resolveDiscoveryApiEntry(),
                 group: catalog?.group ?? null,
+                presentation: 'drawer',
+                title: surface.title,
+                subtitle: surface.description ?? undefined,
+                parentIdentity: runtimeEvent?.resourceIdentity ?? null,
             });
         }
-        catch {
-            return false;
+        catch (error) {
+            this.error.emit(error);
+            this.snack.open(this.txWithParams('crud.surface.openFailed', 'Não foi possível abrir {title}. Tente novamente ou confirme se esse recurso continua disponível.', { title: surface.title || surface.id }), undefined, { duration: 4500 });
+            return true;
         }
+        const focusOrigin = this.resolveRuntimeFocusOrigin(runtimeEvent);
         let openPromise;
         try {
             const surfaceContext = {
@@ -4381,23 +4600,29 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             };
             const handledInline = await this.surfaceOutlets.tryActivate(payload, surfaceContext);
             openPromise = handledInline ? Promise.resolve(undefined) : Promise.resolve(this.surfaceService.open(payload, surfaceContext));
         }
-        catch {
+        catch (error) {
+            if (this.notifySurfaceNavigationFailure(error)) {
+                this.error.emit(error);
+                return true;
+            }
             return false;
         }
-        this.afterOpen.emit({
-            mode: this.mapSurfacePresentationToCrudMode(payload?.presentation),
-            action,
-        });
         try {
             this.bindDiscoveredSurfaceLifecycle(await openPromise);
+            this.afterOpen.emit({
+                mode: this.mapSurfacePresentationToCrudMode(payload?.presentation),
+                action,
+            });
         }
         catch (err) {
             this.error.emit(err);
+            this.notifySurfaceNavigationFailure(err);
         }
         return true;
     }
@@ -4437,17 +4662,37 @@ class PraxisCrudComponent {
         }
         let payload;
         try {
+            const resourceId = this.resolveRowResourceId(row);
             payload = this.getActionOpenAdapter().toPayload(discoveredAction, {
                 resourcePath,
-                resourceId: this.resolveRowResourceId(row),
+                resourceId,
                 endpointKey: this.resolvedMetadata?.resource?.endpointKey,
                 apiUrlEntry: this.resolveDiscoveryApiEntry(),
                 group: catalog?.group ?? null,
             });
+            const resourceIdentity = runtimeEvent?.resourceIdentity ?? null;
+            if (resourceId != null && resourceIdentity) {
+                payload.context = {
+                    ...(payload.context || {}),
+                    operation: {
+                        ...(payload.context?.operation || {}),
+                        subject: {
+                            resourceKey: discoveredAction.resourceKey,
+                            resourceId,
+                            identity: resourceIdentity,
+                        },
+                    },
+                };
+            }
         }
-        catch {
+        catch (error) {
+            if (this.notifySurfaceNavigationFailure(error)) {
+                this.error.emit(error);
+                return true;
+            }
             return false;
         }
+        const focusOrigin = this.resolveRuntimeFocusOrigin(runtimeEvent);
         let openPromise;
         try {
             openPromise = Promise.resolve(this.surfaceService.open(payload, {
@@ -4466,19 +4711,35 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             }));
         }
-        catch {
+        catch (error) {
+            if (this.notifySurfaceNavigationFailure(error)) {
+                this.error.emit(error);
+                return true;
+            }
             return false;
         }
-        this.afterOpen.emit({
-            mode: this.mapSurfacePresentationToCrudMode(payload?.presentation),
-            action,
-        });
-        void openPromise
-            .then((result) => this.handleDiscoveredSurfaceResult(result))
-            .catch((err) => this.error.emit(err));
+        try {
+            this.handleDiscoveredSurfaceResult(await openPromise);
+            this.afterOpen.emit({
+                mode: this.mapSurfacePresentationToCrudMode(payload?.presentation),
+                action,
+            });
+        }
+        catch (err) {
+            this.error.emit(err);
+            this.notifySurfaceNavigationFailure(err);
+        }
+        return true;
+    }
+    notifySurfaceNavigationFailure(error) {
+        if (!isSurfaceNavigationError(error)) {
+            return false;
+        }
+        this.snack.open(translateSurfaceNavigationRejected(this.i18n), undefined, { duration: 4500 });
         return true;
     }
     async resolveDiscoveredActionCatalog(row) {
@@ -4521,13 +4782,13 @@ class PraxisCrudComponent {
         }
         return catalogCandidate;
     }
-    resolveProvidedSurface(action, candidate) {
+    resolveProvidedSurface(_action, candidate) {
         if (!candidate || typeof candidate !== 'object') {
             return null;
         }
         const catalogCandidate = candidate;
         const normalizedId = String(catalogCandidate.id || '').trim().toLowerCase();
-        if (!normalizedId || normalizedId !== action) {
+        if (!normalizedId) {
             return null;
         }
         const surface = catalogCandidate;
@@ -4543,6 +4804,10 @@ class PraxisCrudComponent {
         const candidates = surfaces
             .filter((surface) => surface.availability?.allowed !== false)
             .sort((left, right) => (left.order ?? 0) - (right.order ?? 0));
+        const exact = candidates.find((surface) => String(surface.id || '').trim().toLowerCase() === action);
+        if (exact) {
+            return exact;
+        }
         const preferredIds = this.getPreferredSurfaceIdsForCrudAction(action);
         const preferred = candidates.find((surface) => preferredIds.includes(String(surface.id || '').trim().toLowerCase()));
         if (preferred) {
@@ -5004,7 +5269,8 @@ class PraxisCrudComponent {
             return [];
         }
         return (capabilities.actions || [])
-            .filter((action) => action.scope === 'COLLECTION')
+            .filter((action) => action.scope === 'COLLECTION' &&
+            this.isCatalogActionAvailable(capabilities, action.id))
             .sort((left, right) => (left.order ?? 0) - (right.order ?? 0))
             .map((action) => ({
             action: action.id,
@@ -5025,28 +5291,49 @@ class PraxisCrudComponent {
             appearance: 'outlined',
             position: 'end',
             action: action.id,
-            disabled: action.availability?.allowed === false,
+            disabled: !this.isCatalogActionAvailable(capabilities, action.id),
             tooltip: action.description ||
-                (action.availability?.allowed === false
-                    ? translateUnavailableWorkflowMessage(this.i18n, action.availability)
+                (!this.isCatalogActionAvailable(capabilities, action.id)
+                    ? translateUnavailableWorkflowMessage(this.i18n, capabilities.operations?.[action.id]?.availability || action.availability)
                     : undefined),
         }));
     }
     supportsCreateCapability(snapshot) {
-        return (snapshot.operations?.create?.supported === true ||
-            this.hasCanonicalOperation(snapshot, 'create') ||
+        const operationAvailability = this.resolveOperationAvailability(snapshot, 'create');
+        if (operationAvailability !== null) {
+            return operationAvailability;
+        }
+        return (this.hasCanonicalOperation(snapshot, 'create') ||
             snapshot.surfaces.some((surface) => surface.scope === 'COLLECTION' &&
                 this.isWritableCrudSurface(surface) &&
                 surface.availability?.allowed !== false));
     }
     supportsViewCapability(snapshot) {
-        return snapshot.operations?.view?.supported === true || this.hasCanonicalOperation(snapshot, 'byId');
+        const operationAvailability = this.resolveOperationAvailability(snapshot, 'view');
+        return operationAvailability ?? this.hasCanonicalOperation(snapshot, 'byId');
     }
     supportsEditCapability(snapshot) {
-        return snapshot.operations?.edit?.supported === true || this.hasCanonicalOperation(snapshot, 'update');
+        const operationAvailability = this.resolveOperationAvailability(snapshot, 'edit');
+        return operationAvailability ?? this.hasCanonicalOperation(snapshot, 'update');
     }
     supportsDeleteCapability(snapshot) {
-        return snapshot.operations?.delete?.supported === true || this.hasCanonicalOperation(snapshot, 'delete');
+        const operationAvailability = this.resolveOperationAvailability(snapshot, 'delete');
+        return operationAvailability ?? this.hasCanonicalOperation(snapshot, 'delete');
+    }
+    resolveOperationAvailability(snapshot, operationId) {
+        const operation = snapshot.operations?.[operationId];
+        if (!operation) {
+            return null;
+        }
+        return operation.supported === true && operation.availability?.allowed !== false;
+    }
+    isCatalogActionAvailable(snapshot, actionId) {
+        const action = (snapshot.actions || []).find((candidate) => candidate.id === actionId);
+        if (action?.availability?.allowed === false) {
+            return false;
+        }
+        const operationAvailability = this.resolveOperationAvailability(snapshot, actionId);
+        return operationAvailability ?? true;
     }
     hasCanonicalOperation(snapshot, operation) {
         return snapshot.canonicalOperations?.[operation] === true;
@@ -5137,9 +5424,7 @@ class PraxisCrudComponent {
         const title = resourceLabel
             ? this.txWithParams('crud.table.emptyState.initial.title', 'Sem registros em {label}', { label: resourceLabel })
             : this.tx('crud.table.emptyState.initial.titleFallback', 'Nenhum registro disponível.');
-        const actionId = String(createAction.action || createAction.id || 'create').trim() || 'create';
         const actionLabel = String(createAction.label || this.getCrudActionLabel('create')).trim();
-        const actionIcon = String(createAction.icon || 'add').trim();
         config.behavior = {
             ...behavior,
             emptyState: {
@@ -5147,15 +5432,10 @@ class PraxisCrudComponent {
                 contexts: {
                     initial: {
                         title,
-                        description: this.tx('crud.table.emptyState.initial.descriptionWithAction', 'Use a ação principal para adicionar o primeiro registro quando houver informações para cadastrar.'),
-                        actions: [
-                            {
-                                label: actionLabel,
-                                action: actionId,
-                                icon: actionIcon,
-                                primary: true,
-                            },
-                        ],
+                        description: this.txWithParams('crud.table.emptyState.initial.descriptionWithToolbarAction', 'Use "{action}" na barra da tabela para adicionar o primeiro registro quando houver informações para cadastrar.', { action: actionLabel }),
+                        // The create action is always materialized in the visible collection toolbar.
+                        // Keep the generated empty state instructional so it does not duplicate that CTA.
+                        actions: [],
                     },
                     filtered: {
                         title: this.tx('crud.table.emptyState.filtered.title', 'Nenhum resultado encontrado.'),
@@ -5187,42 +5467,51 @@ class PraxisCrudComponent {
         return Object.entries(params).reduce((current, [name, value]) => current.split(`{${name}}`).join(value), text);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisCrudComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { metadata: "metadata", crudId: "crudId", componentInstanceId: "componentInstanceId", context: "context", enableCustomization: "enableCustomization", authoringCapability: "authoringCapability" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error", rowClick: "rowClick", selectionChange: "selectionChange", tableRuntimeConfigChange: "tableRuntimeConfigChange", crudAuthoringDocumentApplied: "crudAuthoringDocumentApplied", crudAuthoringDocumentSaved: "crudAuthoringDocumentSaved" }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { metadata: "metadata", crudId: "crudId", componentInstanceId: "componentInstanceId", tableConfigPersistenceStrategy: "tableConfigPersistenceStrategy", context: "context", enableCustomization: "enableCustomization", authoringCapability: "authoringCapability" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error", rowClick: "rowClick", rowAction: "rowAction", selectionChange: "selectionChange", tableRuntimeConfigChange: "tableRuntimeConfigChange", crudAuthoringDocumentApplied: "crudAuthoringDocumentApplied", crudAuthoringDocumentSaved: "crudAuthoringDocumentSaved" }, providers: [
             providePraxisI18nConfig(RESOURCE_DISCOVERY_I18N_CONFIG),
             providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
         ], viewQueries: [{ propertyName: "table", first: true, predicate: PraxisTable, descendants: true }], usesOnChanges: true, ngImport: i0, template: `
-    @if (shouldRenderTable(resolvedMetadata)) {
-      <praxis-table
-        [config]="tableConfigForBinding"
-        [resourcePath]="resolveResourcePath(resolvedMetadata)"
-        [data]="resolveTableData(resolvedMetadata)"
-        [queryContext]="tableQueryContext"
-        [filterCriteria]="tableFilterCriteria"
-        [tableId]="crudId || 'default'"
-        [crudContext]="tableCrudContext"
-        [enableCustomization]="enableCustomization"
-        [authoringCapability]="authoringCapability"
-        (rowClick)="onTableRowClick($event)"
-        (selectionChange)="onTableSelectionChange($event)"
-        (rowAction)="onAction($event.action, $event.row, $event)"
-        (toolbarAction)="onToolbarAction($event)"
-        (bulkAction)="onBulkAction($event)"
-        (collectionLinksChange)="onCollectionLinksChange($event)"
-        (reset)="onResetPreferences()"
-        (metadataChange)="onTableMetadataChange()"
-        (loadingStateChange)="onTableLoadingStateChange($event)"
-      ></praxis-table>
-    } @else {
-      @if (isCustomizationAvailable()) {
-        <praxis-empty-state-card
-          icon="table_rows"
-          [title]="getEmptyStateTitle()"
-          [description]="getEmptyStateDescription()"
-          [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
-        />
+    <div class="praxis-crud-runtime" [attr.aria-busy]="openingActionLabel() ? 'true' : null">
+      @if (openingActionLabel(); as actionLabel) {
+        <div class="praxis-crud-opening-status" role="status" aria-live="polite" data-testid="praxis-crud-opening-status">
+          <span class="praxis-crud-opening-status__spinner" aria-hidden="true"></span>
+          <span>{{ getOpeningActionStatus(actionLabel) }}</span>
+        </div>
       }
-    }
-  `, 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", "authoringCapability", "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"] }] });
+      @if (shouldRenderTable(resolvedMetadata)) {
+        <praxis-table
+          [config]="tableConfigForBinding"
+          [resourcePath]="resolveResourcePath(resolvedMetadata)"
+          [data]="resolveTableData(resolvedMetadata)"
+          [queryContext]="tableQueryContext"
+          [filterCriteria]="tableFilterCriteria"
+          [tableId]="crudId || 'default'"
+          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
+          [crudContext]="tableCrudContext"
+          [enableCustomization]="enableCustomization"
+          [authoringCapability]="authoringCapability"
+          (rowClick)="onTableRowClick($event)"
+          (selectionChange)="onTableSelectionChange($event)"
+          (rowAction)="onTableRowAction($event)"
+          (toolbarAction)="onToolbarAction($event)"
+          (bulkAction)="onBulkAction($event)"
+          (collectionLinksChange)="onCollectionLinksChange($event)"
+          (reset)="onResetPreferences()"
+          (metadataChange)="onTableMetadataChange()"
+          (loadingStateChange)="onTableLoadingStateChange($event)"
+        ></praxis-table>
+      } @else {
+        @if (isCustomizationAvailable()) {
+          <praxis-empty-state-card
+            icon="table_rows"
+            [title]="getEmptyStateTitle()"
+            [description]="getEmptyStateDescription()"
+            [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
+          />
+        }
+      }
+    </div>
+  `, isInline: true, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}.praxis-crud-runtime{position:relative;min-width:0}.praxis-crud-opening-status{position:absolute;z-index:6;top:.7rem;right:.7rem;display:inline-flex;align-items:center;gap:.55rem;min-height:2.25rem;max-width:min(24rem,calc(100% - 1.4rem));padding:.48rem .72rem;border:1px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 32%,transparent);border-radius:999px;color:var(--md-sys-color-on-surface, currentColor);background:color-mix(in srgb,var(--md-sys-color-surface-container-high, #fff) 94%,transparent);box-shadow:0 10px 28px #0f172a29;font-size:.82rem;font-weight:650;line-height:1.25;pointer-events:none}.praxis-crud-opening-status__spinner{width:.95rem;height:.95rem;flex:0 0 auto;border:2px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 26%,transparent);border-top-color:var(--md-sys-color-primary, #3f51b5);border-radius:50%;animation:praxis-crud-opening-spin .72s linear infinite}@keyframes praxis-crud-opening-spin{to{transform:rotate(360deg)}}@media(prefers-reduced-motion:reduce){.praxis-crud-opening-status__spinner{animation:none;border-top-color:currentColor}}\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", "authoringCapability", "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,
@@ -5230,38 +5519,47 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         providePraxisI18nConfig(RESOURCE_DISCOVERY_I18N_CONFIG),
                         providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
                     ], template: `
-    @if (shouldRenderTable(resolvedMetadata)) {
-      <praxis-table
-        [config]="tableConfigForBinding"
-        [resourcePath]="resolveResourcePath(resolvedMetadata)"
-        [data]="resolveTableData(resolvedMetadata)"
-        [queryContext]="tableQueryContext"
-        [filterCriteria]="tableFilterCriteria"
-        [tableId]="crudId || 'default'"
-        [crudContext]="tableCrudContext"
-        [enableCustomization]="enableCustomization"
-        [authoringCapability]="authoringCapability"
-        (rowClick)="onTableRowClick($event)"
-        (selectionChange)="onTableSelectionChange($event)"
-        (rowAction)="onAction($event.action, $event.row, $event)"
-        (toolbarAction)="onToolbarAction($event)"
-        (bulkAction)="onBulkAction($event)"
-        (collectionLinksChange)="onCollectionLinksChange($event)"
-        (reset)="onResetPreferences()"
-        (metadataChange)="onTableMetadataChange()"
-        (loadingStateChange)="onTableLoadingStateChange($event)"
-      ></praxis-table>
-    } @else {
-      @if (isCustomizationAvailable()) {
-        <praxis-empty-state-card
-          icon="table_rows"
-          [title]="getEmptyStateTitle()"
-          [description]="getEmptyStateDescription()"
-          [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
-        />
+    <div class="praxis-crud-runtime" [attr.aria-busy]="openingActionLabel() ? 'true' : null">
+      @if (openingActionLabel(); as actionLabel) {
+        <div class="praxis-crud-opening-status" role="status" aria-live="polite" data-testid="praxis-crud-opening-status">
+          <span class="praxis-crud-opening-status__spinner" aria-hidden="true"></span>
+          <span>{{ getOpeningActionStatus(actionLabel) }}</span>
+        </div>
       }
-    }
-  `, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}\n"] }]
+      @if (shouldRenderTable(resolvedMetadata)) {
+        <praxis-table
+          [config]="tableConfigForBinding"
+          [resourcePath]="resolveResourcePath(resolvedMetadata)"
+          [data]="resolveTableData(resolvedMetadata)"
+          [queryContext]="tableQueryContext"
+          [filterCriteria]="tableFilterCriteria"
+          [tableId]="crudId || 'default'"
+          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
+          [crudContext]="tableCrudContext"
+          [enableCustomization]="enableCustomization"
+          [authoringCapability]="authoringCapability"
+          (rowClick)="onTableRowClick($event)"
+          (selectionChange)="onTableSelectionChange($event)"
+          (rowAction)="onTableRowAction($event)"
+          (toolbarAction)="onToolbarAction($event)"
+          (bulkAction)="onBulkAction($event)"
+          (collectionLinksChange)="onCollectionLinksChange($event)"
+          (reset)="onResetPreferences()"
+          (metadataChange)="onTableMetadataChange()"
+          (loadingStateChange)="onTableLoadingStateChange($event)"
+        ></praxis-table>
+      } @else {
+        @if (isCustomizationAvailable()) {
+          <praxis-empty-state-card
+            icon="table_rows"
+            [title]="getEmptyStateTitle()"
+            [description]="getEmptyStateDescription()"
+            [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
+          />
+        }
+      }
+    </div>
+  `, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}.praxis-crud-runtime{position:relative;min-width:0}.praxis-crud-opening-status{position:absolute;z-index:6;top:.7rem;right:.7rem;display:inline-flex;align-items:center;gap:.55rem;min-height:2.25rem;max-width:min(24rem,calc(100% - 1.4rem));padding:.48rem .72rem;border:1px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 32%,transparent);border-radius:999px;color:var(--md-sys-color-on-surface, currentColor);background:color-mix(in srgb,var(--md-sys-color-surface-container-high, #fff) 94%,transparent);box-shadow:0 10px 28px #0f172a29;font-size:.82rem;font-weight:650;line-height:1.25;pointer-events:none}.praxis-crud-opening-status__spinner{width:.95rem;height:.95rem;flex:0 0 auto;border:2px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 26%,transparent);border-top-color:var(--md-sys-color-primary, #3f51b5);border-radius:50%;animation:praxis-crud-opening-spin .72s linear infinite}@keyframes praxis-crud-opening-spin{to{transform:rotate(360deg)}}@media(prefers-reduced-motion:reduce){.praxis-crud-opening-status__spinner{animation:none;border-top-color:currentColor}}\n"] }]
         }], ctorParameters: () => [], propDecorators: { metadata: [{
                 type: Input,
                 args: [{ required: true }]
@@ -5270,6 +5568,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 args: [{ required: true }]
             }], componentInstanceId: [{
                 type: Input
+            }], tableConfigPersistenceStrategy: [{
+                type: Input
             }], context: [{
                 type: Input
             }], enableCustomization: [{
@@ -5290,6 +5590,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Output
             }], rowClick: [{
                 type: Output
+            }], rowAction: [{
+                type: Output
             }], selectionChange: [{
                 type: Output
             }], tableRuntimeConfigChange: [{
@@ -5326,10 +5628,10 @@ function debugCrudHost(message, data) {
 }
 class DynamicFormDialogHostComponent {
     dialogRef;
-    data;
     dialogService;
     crud;
     configStorage;
+    surfaceRef;
     formComp;
     modal = {};
     presentation = 'modal';
@@ -5339,12 +5641,14 @@ class DynamicFormDialogHostComponent {
     rememberState = false;
     stateKey;
     backDefaults = {};
+    terminalClose = false;
     destroyRef = inject(DestroyRef);
     i18n = inject(PraxisI18nService);
     resourcePath;
     resourceId;
     initialValue;
     resourceIdentity = null;
+    contextIdentity = null;
     schemaUrl;
     submitUrl;
     submitMethod;
@@ -5354,9 +5658,12 @@ class DynamicFormDialogHostComponent {
     formConfig = {};
     formActions;
     formConfigPersistenceStrategy = 'input-first';
+    fieldIconPolicy = 'presentation-only';
     mode = 'create';
     backConfig;
     idField = 'id';
+    isSurfaceFrame;
+    data;
     texts = {
         title: 'Formulário',
         close: 'Fechar',
@@ -5364,19 +5671,32 @@ class DynamicFormDialogHostComponent {
         maximizeLabel: 'Maximizar',
         restoreLabel: 'Restaurar',
         recordContextLabel: translateCrudRuntimeText(this.i18n, 'crud.dialog.recordContextLabel', 'Registro em edição'),
+        viewRecordContextLabel: translateCrudRuntimeText(this.i18n, 'crud.dialog.viewRecordContextLabel', 'Registro em consulta'),
+        relatedContextLabel: translateCrudRuntimeText(this.i18n, 'crud.dialog.relatedContextLabel', 'Vinculado a'),
         discardTitle: 'Descartar alterações?',
         discardMessage: 'Você tem alterações não salvas. Deseja fechar assim mesmo?',
         discardConfirm: 'Descartar',
         discardCancel: 'Cancelar',
     };
-    constructor(dialogRef, data, dialogService, crud, configStorage) {
+    constructor(dialogRef, dialogData, dialogService, crud, configStorage, surfaceRef = null, surfaceContentData = null) {
         this.dialogRef = dialogRef;
-        this.data = data;
         this.dialogService = dialogService;
         this.crud = crud;
         this.configStorage = configStorage;
-        this.dialogRef.disableClose = true;
-        this.presentation = this.data.presentation === 'drawer' ? 'drawer' : 'modal';
+        this.surfaceRef = surfaceRef;
+        this.data = dialogData ?? surfaceContentData?.['data'] ?? {};
+        this.isSurfaceFrame = !!this.surfaceRef;
+        if (!this.dialogRef && !this.surfaceRef) {
+            throw new Error('DynamicFormDialogHostComponent requires a MatDialogRef or an active SurfaceDrawerRef.');
+        }
+        if (this.dialogRef) {
+            this.dialogRef.disableClose = true;
+        }
+        this.presentation = this.isSurfaceFrame
+            ? 'surface-frame'
+            : this.data.presentation === 'drawer'
+                ? 'drawer'
+                : 'modal';
         // i18n
         this.texts = {
             ...this.texts,
@@ -5414,9 +5734,12 @@ 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.resourceIdentity = this.mode === 'edit' && this.data.resourceIdentity
+        this.resourceIdentity = this.mode !== 'create' && this.data.resourceIdentity
             ? this.data.resourceIdentity
             : null;
+        this.contextIdentity = this.data.contextIdentity
+            ? this.data.contextIdentity
+            : null;
         this.formConfig = this.resolveFormConfig();
         this.layoutPolicy = this.resolveLayoutPolicy();
         this.formActions = this.resolveFormActions();
@@ -5433,14 +5756,14 @@ class DynamicFormDialogHostComponent {
             backConfig: this.backConfig,
         });
         // Esc
-        if (!this.modal.disableCloseOnEsc) {
+        if (this.dialogRef && !this.modal.disableCloseOnEsc) {
             this.dialogRef
                 .keydownEvents()
                 .pipe(filter((e) => e.key === 'Escape'), takeUntilDestroyed(this.destroyRef))
                 .subscribe(() => this.onCancel());
         }
         // Backdrop
-        if (!this.modal.disableCloseOnBackdrop) {
+        if (this.dialogRef && !this.modal.disableCloseOnBackdrop) {
             this.dialogRef
                 .backdropClick()
                 .pipe(takeUntilDestroyed(this.destroyRef))
@@ -5448,10 +5771,36 @@ class DynamicFormDialogHostComponent {
         }
         // Salvar estado ao fechar, se aplicável
         this.dialogRef
-            .afterClosed()
+            ?.afterClosed()
             .pipe(takeUntilDestroyed(this.destroyRef))
             .subscribe(() => this.saveState());
     }
+    get resourceIdentityLabel() {
+        return this.mode === 'view'
+            ? this.texts['viewRecordContextLabel']
+            : this.texts['recordContextLabel'];
+    }
+    get showContextIdentity() {
+        return !!this.contextIdentity && !this.sameIdentity(this.contextIdentity, this.resourceIdentity);
+    }
+    sameIdentity(left, right) {
+        if (!left || !right)
+            return false;
+        const leftKey = left.key;
+        const rightKey = right.key;
+        const leftLabel = this.identityLabel(left);
+        const rightLabel = this.identityLabel(right);
+        if (leftKey && rightKey) {
+            return leftKey.field === rightKey.field
+                && String(leftKey.value) === String(rightKey.value)
+                && !!leftLabel
+                && leftLabel === rightLabel;
+        }
+        return !!leftLabel && leftLabel === rightLabel;
+    }
+    identityLabel(identity) {
+        return String(identity.displayLabel || identity.title?.value || '').trim();
+    }
     extractInitialValue(inputs) {
         if (!inputs || typeof inputs !== 'object') {
             return null;
@@ -5488,6 +5837,22 @@ class DynamicFormDialogHostComponent {
             deriveModeTitle(this.mode, this.resolveResourceTitle()) ||
             this.texts.title;
     }
+    get dialogSubtitle() {
+        const action = this.data.action ?? {};
+        const form = this.formConfig;
+        const resource = this.data.metadata?.resource ?? {};
+        const table = this.data.metadata?.table ?? {};
+        return stringOrUndefined(action.description ??
+            action.tooltip ??
+            form['description'] ??
+            resource.description ??
+            table.subtitle ??
+            table.description);
+    }
+    get dialogIcon() {
+        const action = this.data.action ?? {};
+        return stringOrUndefined(action.icon ?? this.modal.titleIcon ?? this.modal.icon);
+    }
     resolveActionDialogTitle() {
         const actionLabel = stringOrUndefined(this.data.action?.label);
         if (!actionLabel) {
@@ -5518,7 +5883,7 @@ class DynamicFormDialogHostComponent {
         if (this.mode === 'view') {
             return undefined;
         }
-        if (this.formConfig?.actions) {
+        if (this.formConfig?.actions?.submit) {
             return undefined;
         }
         const submitLabel = this.resolveSubmitLabel();
@@ -5590,6 +5955,13 @@ class DynamicFormDialogHostComponent {
             });
         }
     }
+    ngAfterViewInit() {
+        if (!this.surfaceRef?.setCanLeave) {
+            return;
+        }
+        this.surfaceRef.updateTitle?.(this.dialogTitle);
+        this.surfaceRef.setCanLeave(() => this.canLeaveSurfaceFrame());
+    }
     onSave(result) {
         const stage = getFormSubmitStage(result);
         if (stage === 'before' || stage === 'error') {
@@ -5599,9 +5971,29 @@ class DynamicFormDialogHostComponent {
             this.saveState();
             return;
         }
-        this.dialogRef.close({ type: 'save', data: result });
+        this.terminalClose = true;
+        this.formComp?.form.markAsPristine();
+        if (this.surfaceRef) {
+            this.surfaceRef.emitResult?.({ type: 'save', data: result });
+            this.surfaceRef.close?.({ type: 'save', data: result });
+        }
+        else {
+            this.dialogRef?.close({ type: 'save', data: result });
+        }
     }
     onCancel() {
+        if (this.surfaceRef) {
+            void this.canLeaveSurfaceFrame().then((allowed) => {
+                if (!allowed)
+                    return;
+                // `close()` on a nested frame consults the registered guard again.
+                // Mark this user-confirmed transition so both root and nested frames
+                // share one prompt and one close result.
+                this.terminalClose = true;
+                this.surfaceRef?.close?.({ type: 'close' });
+            });
+            return;
+        }
         const dirty = this.formComp?.form.dirty;
         const backCfg = (this.data.action?.back || this.data.metadata?.defaults?.back) || {};
         const confirm = backCfg.confirmOnDirty ?? true;
@@ -5619,12 +6011,32 @@ class DynamicFormDialogHostComponent {
             ref
                 .afterClosed()
                 .pipe(filter((confirmed) => !!confirmed), takeUntilDestroyed(this.destroyRef))
-                .subscribe(() => this.dialogRef.close({ type: 'close' }));
+                .subscribe(() => this.dialogRef?.close({ type: 'close' }));
         }
         else {
-            this.dialogRef.close({ type: 'close' });
+            this.dialogRef?.close({ type: 'close' });
         }
     }
+    async canLeaveSurfaceFrame() {
+        if (this.terminalClose || !this.formComp?.form.dirty) {
+            return true;
+        }
+        const backCfg = (this.data.action?.back || this.data.metadata?.defaults?.back) || {};
+        if (backCfg.confirmOnDirty === false) {
+            return true;
+        }
+        const ref = this.dialogService.open(ConfirmDialogComponent, {
+            data: {
+                title: this.texts.discardTitle,
+                message: this.texts.discardMessage,
+                confirmText: this.texts.discardConfirm,
+                cancelText: this.texts.discardCancel,
+                type: 'warning',
+            },
+            autoFocus: false,
+        });
+        return !!(await firstValueFrom(ref.afterClosed().pipe(take(1))));
+    }
     toggleMaximize(initial = false) {
         const pane = this.resolveOverlayPane();
         if (!initial && !this.maximized && pane) {
@@ -5638,7 +6050,12 @@ class DynamicFormDialogHostComponent {
         const height = this.maximized
             ? `calc(100dvh - ${2 * (gap ?? 0)}px)`
             : this.initialSize.height;
-        this.dialogRef.updateSize(width, height);
+        if (this.surfaceRef) {
+            this.surfaceRef.updateSize?.(this.maximized ? 'full' : 'default');
+        }
+        else {
+            this.dialogRef?.updateSize(width, height);
+        }
         this.updateHostPosition();
         if (pane && pane.classList.contains('pfx-dialog-pane')) {
             if (this.presentation === 'drawer') {
@@ -5695,6 +6112,9 @@ class DynamicFormDialogHostComponent {
             startMaximized: this.modal.startMaximized,
             fullscreenBreakpoint: this.modal.fullscreenBreakpoint,
         });
+        if (this.surfaceRef) {
+            return;
+        }
         let shouldMax = false;
         if (saved && typeof saved.maximized === 'boolean') {
             shouldMax = !!saved.maximized;
@@ -5709,16 +6129,19 @@ class DynamicFormDialogHostComponent {
             this.toggleMaximize(true);
         }
         else if (this.initialSize.width || this.initialSize.height) {
-            this.dialogRef.updateSize(this.initialSize.width, this.initialSize.height);
+            this.dialogRef?.updateSize(this.initialSize.width, this.initialSize.height);
             this.updateHostPosition();
         }
     }
     updateHostPosition() {
+        if (this.surfaceRef) {
+            return;
+        }
         if (this.presentation !== 'drawer') {
-            this.dialogRef.updatePosition();
+            this.dialogRef?.updatePosition();
             return;
         }
-        this.dialogRef.updatePosition(this.maximized
+        this.dialogRef?.updatePosition(this.maximized
             ? this.resolveMaximizedDrawerPosition()
             : this.initialPosition);
     }
@@ -5733,15 +6156,28 @@ class DynamicFormDialogHostComponent {
             : { top: offset };
         return { ...horizontal, ...vertical };
     }
-    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\"", "attr.data-presentation": "presentation", "class.praxis-drawer": "presentation === \"drawer\"" }, classAttribute: "praxis-dialog" }, providers: [
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicFormDialogHostComponent, deps: [{ token: MatDialogRef, optional: true }, { token: MAT_DIALOG_DATA, optional: true }, { token: DialogService }, { token: i2$1.GenericCrudService }, { token: ASYNC_CONFIG_STORAGE }, { token: SURFACE_DRAWER_REF, optional: true }, { token: SURFACE_DRAWER_CONTENT_DATA, optional: true }], 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\"", "attr.data-presentation": "presentation", "class.praxis-drawer": "presentation === \"drawer\"", "class.praxis-surface-frame": "isSurfaceFrame" }, classAttribute: "praxis-dialog" }, providers: [
             GenericCrudService,
             providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
         ], viewQueries: [{ propertyName: "formComp", first: true, predicate: PraxisDynamicForm, descendants: true }], ngImport: i0, template: `
+    @if (!isSurfaceFrame) {
     <div mat-dialog-title class="dialog-header">
-      <h2 id="crudDialogTitle" class="dialog-title">
-        {{ dialogTitle }}
-      </h2>
+      @if (dialogIcon; as icon) {
+        <span class="dialog-title-icon" aria-hidden="true">
+          <mat-icon [praxisIcon]="icon"></mat-icon>
+        </span>
+      }
+      <span class="dialog-heading">
+        <h2 id="crudDialogTitle" class="dialog-title">
+          {{ dialogTitle }}
+        </h2>
+        @if (dialogSubtitle; as subtitle) {
+          <span id="crudDialogDescription" class="dialog-subtitle">
+            {{ subtitle }}
+          </span>
+        }
+      </span>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
         <button
@@ -5761,22 +6197,43 @@ class DynamicFormDialogHostComponent {
         cdkFocusInitial
       ></button>
     </div>
+    }
 
     <mat-dialog-content
       class="dialog-content"
-      aria-labelledby="crudDialogTitle"
+      [attr.aria-labelledby]="isSurfaceFrame ? null : 'crudDialogTitle'"
+      [attr.aria-describedby]="
+        !isSurfaceFrame && dialogSubtitle ? 'crudDialogDescription' : null
+      "
     >
-      @if (resourceIdentity) {
-        <div class="crud-resource-identity" data-testid="crud-resource-identity">
-          <span class="crud-resource-identity__label" aria-hidden="true">
-            {{ texts.recordContextLabel }}
-          </span>
-          <praxis-resource-identity
-            [identity]="resourceIdentity"
-            density="compact"
-            [showKeyLabel]="true"
-            [ariaLabel]="texts.recordContextLabel"
-          ></praxis-resource-identity>
+      @if (showContextIdentity || resourceIdentity) {
+        <div class="crud-operation-context" data-testid="crud-operation-context">
+          @if (showContextIdentity) {
+            <div class="crud-resource-identity" data-testid="crud-context-identity">
+              <span class="crud-resource-identity__label" aria-hidden="true">
+                {{ texts.relatedContextLabel }}
+              </span>
+              <praxis-resource-identity
+                [identity]="contextIdentity"
+                density="compact"
+                [showKeyLabel]="true"
+                [ariaLabel]="texts.relatedContextLabel"
+              ></praxis-resource-identity>
+            </div>
+          }
+          @if (resourceIdentity) {
+            <div class="crud-resource-identity" data-testid="crud-resource-identity">
+              <span class="crud-resource-identity__label" aria-hidden="true">
+                {{ resourceIdentityLabel }}
+              </span>
+              <praxis-resource-identity
+                [identity]="resourceIdentity"
+                density="compact"
+                [showKeyLabel]="true"
+                [ariaLabel]="resourceIdentityLabel"
+              ></praxis-resource-identity>
+            </div>
+          }
         </div>
       }
       <praxis-dynamic-form
@@ -5794,19 +6251,22 @@ class DynamicFormDialogHostComponent {
         [configPersistenceStrategy]="formConfigPersistenceStrategy"
         [layoutPolicy]="layoutPolicy"
         [presentationModeGlobal]="mode === 'view' ? true : null"
+        [fieldIconPolicy]="fieldIconPolicy"
         [backConfig]="backConfig"
         [actions]="formActions"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, 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 .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}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.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}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.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.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: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }, { kind: "component", type: PraxisResourceIdentityComponent, selector: "praxis-resource-identity", inputs: ["identity", "emptyTitle", "density", "showMetadataLabels", "showKeyLabel", "ariaLabel"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "submitIdempotencyKey", "submitCorrelationId", "submitResourceVersion", "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 });
+  `, 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);min-height:var(--dlg-header-h);padding:10px var(--dlg-pad);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 .dialog-heading{display:grid;min-width:0;gap:2px}praxis-dynamic-form-dialog-host .dialog-title-icon{display:inline-grid;flex:0 0 auto;width:36px;height:36px;place-items:center;border-radius:10px;color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary) 12%,transparent)}praxis-dynamic-form-dialog-host .dialog-title-icon mat-icon{width:22px;height:22px;font-size:22px}praxis-dynamic-form-dialog-host .dialog-subtitle{display:-webkit-box;overflow:hidden;color:var(--md-sys-color-on-surface-variant);font-size:.82rem;font-weight:400;line-height:1.35;-webkit-box-orient:vertical;-webkit-line-clamp:2}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 .crud-operation-context{position:sticky;top:0;z-index:1;display:grid;gap:.75rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity{display:grid;gap:.25rem;min-width:0}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 72px;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{display:flex;flex-direction:column;max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form{display:block;flex:1 1 auto;min-height:0}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form>.praxis-dynamic-form{min-height:100%}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form>.praxis-dynamic-form>praxis-form-actions[data-actions-placement=afterSections]{margin-top:auto;padding-top:var(--pfx-actions-gap-top, var(--pfx-section-gap, 20px))}praxis-dynamic-form-dialog-host.praxis-surface-frame .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}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%;min-width:0;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.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{min-width:0!important;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: MatIconModule }, { kind: "component", type: i6.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisResourceIdentityComponent, selector: "praxis-resource-identity", inputs: ["identity", "emptyTitle", "density", "showMetadataLabels", "showKeyLabel", "ariaLabel"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "submitIdempotencyKey", "submitCorrelationId", "submitResourceVersion", "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,
             args: [{ selector: 'praxis-dynamic-form-dialog-host', standalone: true, imports: [
                         MatDialogModule,
+                        MatIconModule,
                         PraxisIconButtonComponent,
+                        PraxisIconDirective,
                         PraxisResourceIdentityComponent,
                         PraxisDynamicForm
                     ], encapsulation: ViewEncapsulation.None, providers: [
@@ -5817,11 +6277,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         '[attr.data-density]': 'modal.density || "default"',
                         '[attr.data-presentation]': 'presentation',
                         '[class.praxis-drawer]': 'presentation === "drawer"',
+                        '[class.praxis-surface-frame]': 'isSurfaceFrame',
                     }, template: `
+    @if (!isSurfaceFrame) {
     <div mat-dialog-title class="dialog-header">
-      <h2 id="crudDialogTitle" class="dialog-title">
-        {{ dialogTitle }}
-      </h2>
+      @if (dialogIcon; as icon) {
+        <span class="dialog-title-icon" aria-hidden="true">
+          <mat-icon [praxisIcon]="icon"></mat-icon>
+        </span>
+      }
+      <span class="dialog-heading">
+        <h2 id="crudDialogTitle" class="dialog-title">
+          {{ dialogTitle }}
+        </h2>
+        @if (dialogSubtitle; as subtitle) {
+          <span id="crudDialogDescription" class="dialog-subtitle">
+            {{ subtitle }}
+          </span>
+        }
+      </span>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
         <button
@@ -5841,22 +6315,43 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         cdkFocusInitial
       ></button>
     </div>
+    }
 
     <mat-dialog-content
       class="dialog-content"
-      aria-labelledby="crudDialogTitle"
+      [attr.aria-labelledby]="isSurfaceFrame ? null : 'crudDialogTitle'"
+      [attr.aria-describedby]="
+        !isSurfaceFrame && dialogSubtitle ? 'crudDialogDescription' : null
+      "
     >
-      @if (resourceIdentity) {
-        <div class="crud-resource-identity" data-testid="crud-resource-identity">
-          <span class="crud-resource-identity__label" aria-hidden="true">
-            {{ texts.recordContextLabel }}
-          </span>
-          <praxis-resource-identity
-            [identity]="resourceIdentity"
-            density="compact"
-            [showKeyLabel]="true"
-            [ariaLabel]="texts.recordContextLabel"
-          ></praxis-resource-identity>
+      @if (showContextIdentity || resourceIdentity) {
+        <div class="crud-operation-context" data-testid="crud-operation-context">
+          @if (showContextIdentity) {
+            <div class="crud-resource-identity" data-testid="crud-context-identity">
+              <span class="crud-resource-identity__label" aria-hidden="true">
+                {{ texts.relatedContextLabel }}
+              </span>
+              <praxis-resource-identity
+                [identity]="contextIdentity"
+                density="compact"
+                [showKeyLabel]="true"
+                [ariaLabel]="texts.relatedContextLabel"
+              ></praxis-resource-identity>
+            </div>
+          }
+          @if (resourceIdentity) {
+            <div class="crud-resource-identity" data-testid="crud-resource-identity">
+              <span class="crud-resource-identity__label" aria-hidden="true">
+                {{ resourceIdentityLabel }}
+              </span>
+              <praxis-resource-identity
+                [identity]="resourceIdentity"
+                density="compact"
+                [showKeyLabel]="true"
+                [ariaLabel]="resourceIdentityLabel"
+              ></praxis-resource-identity>
+            </div>
+          }
         </div>
       }
       <praxis-dynamic-form
@@ -5874,22 +6369,37 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         [configPersistenceStrategy]="formConfigPersistenceStrategy"
         [layoutPolicy]="layoutPolicy"
         [presentationModeGlobal]="mode === 'view' ? true : null"
+        [fieldIconPolicy]="fieldIconPolicy"
         [backConfig]="backConfig"
         [actions]="formActions"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, 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 .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}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.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}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.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{border-radius:0!important}\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);min-height:var(--dlg-header-h);padding:10px var(--dlg-pad);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 .dialog-heading{display:grid;min-width:0;gap:2px}praxis-dynamic-form-dialog-host .dialog-title-icon{display:inline-grid;flex:0 0 auto;width:36px;height:36px;place-items:center;border-radius:10px;color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary) 12%,transparent)}praxis-dynamic-form-dialog-host .dialog-title-icon mat-icon{width:22px;height:22px;font-size:22px}praxis-dynamic-form-dialog-host .dialog-subtitle{display:-webkit-box;overflow:hidden;color:var(--md-sys-color-on-surface-variant);font-size:.82rem;font-weight:400;line-height:1.35;-webkit-box-orient:vertical;-webkit-line-clamp:2}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 .crud-operation-context{position:sticky;top:0;z-index:1;display:grid;gap:.75rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity{display:grid;gap:.25rem;min-width:0}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 72px;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{display:flex;flex-direction:column;max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form{display:block;flex:1 1 auto;min-height:0}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form>.praxis-dynamic-form{min-height:100%}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content>praxis-dynamic-form>.praxis-dynamic-form>praxis-form-actions[data-actions-placement=afterSections]{margin-top:auto;padding-top:var(--pfx-actions-gap-top, var(--pfx-section-gap, 20px))}praxis-dynamic-form-dialog-host.praxis-surface-frame .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}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%;min-width:0;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.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{min-width:0!important;border-radius:0!important}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Optional
+                }, {
                     type: Inject,
                     args: [MatDialogRef]
                 }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
                     type: Inject,
                     args: [MAT_DIALOG_DATA]
                 }] }, { type: DialogService }, { type: i2$1.GenericCrudService }, { type: undefined, decorators: [{
                     type: Inject,
                     args: [ASYNC_CONFIG_STORAGE]
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [SURFACE_DRAWER_REF]
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [SURFACE_DRAWER_CONTENT_DATA]
                 }] }], propDecorators: { formComp: [{
                 type: ViewChild,
                 args: [PraxisDynamicForm]
@@ -6119,6 +6629,12 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             type: 'string',
             description: 'Identificador opcional para múltiplas instâncias na mesma rota.',
         },
+        {
+            name: 'tableConfigPersistenceStrategy',
+            type: "'local-first' | 'input-first' | 'volatile'",
+            default: 'local-first',
+            description: 'Política da tabela interna. Use input-first para contratos governados autoritativos e volatile para previews que não devem ler nem gravar preferências locais.',
+        },
         {
             name: 'context',
             type: 'Record<string, unknown>',
@@ -6198,6 +6714,11 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             type: '{ row: unknown; index: number }',
             description: 'Encaminha o clique de linha da tabela interna para composição master-detail e seleção local.',
         },
+        {
+            name: 'rowAction',
+            type: 'CrudActionRuntimeEvent',
+            description: 'Encaminha a ação contextual da linha com row, action e resourceIdentity para composição governada.',
+        },
         {
             name: 'selectionChange',
             type: 'unknown',
@@ -6694,6 +7215,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { name: 'metadata', type: 'CrudMetadata | string', description: 'Canonical CRUD metadata or serialized metadata document.' },
         { name: 'crudId', type: 'string', description: 'Stable CRUD instance id used for table/form identity and persistence.' },
         { name: 'componentInstanceId', type: 'string', description: 'Optional stable host instance id for multiple CRUD widgets on the same route.' },
+        { name: 'tableConfigPersistenceStrategy', type: "'local-first' | 'input-first' | 'volatile'", description: 'Persistence precedence forwarded to the internal Praxis Table. Governed previews should use input-first or volatile explicitly.' },
         { name: 'context', type: 'Record<string, unknown>', description: 'Opaque host context used for authoring seeds and launcher inputs.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Explicit host opt-in for CRUD authoring surfaces.' },
         { name: 'authoringCapability', type: 'string | null', description: 'Public runtime capability required before CRUD and delegated table authoring can open.' },