@praxisui/crud 9.0.4-rc.35 → 9.0.4-rc.37

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-05T17:32:01.038Z",
+  "generatedAt": "2026-08-09T11:18:35.694Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "9.0.4-rc.35",
+  "packageVersion": "9.0.4-rc.37",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-crud.mjs

@@ -97,6 +97,35 @@ 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);
@@ -115,6 +144,15 @@ 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;
@@ -156,6 +194,8 @@ class CrudLauncherService {
             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({
@@ -163,6 +203,9 @@ class CrudLauncherService {
                 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 },
@@ -197,12 +240,12 @@ class CrudLauncherService {
                 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,
@@ -233,7 +276,7 @@ class CrudLauncherService {
             panelClass: panelClasses,
             backdropClass: mergedBackdropClasses,
             autoFocus: modalCfg.autoFocus ?? true,
-            restoreFocus: modalCfg.restoreFocus ?? true,
+            restoreFocus,
             minWidth: drawerMode
                 ? (modalCfg.minWidth ?? DEFAULT_CRUD_DRAWER_MODAL_CONFIG.minWidth)
                 : '360px',
@@ -986,7 +1029,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',
@@ -1009,7 +1052,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',
@@ -4006,6 +4049,7 @@ class PraxisCrudComponent {
                 links: this.resolveCrudRuntimeLinks(effectiveAction.action, contextualRow),
                 resourceIdentity,
                 contextIdentity,
+                focusOrigin: runtimeEvent?.focusOrigin ?? null,
                 surfaceRuntime: this.resolveSurfaceRuntime(),
             });
             this.afterOpen.emit({ mode, action: effectiveAction.action });
@@ -4467,6 +4511,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'
@@ -4516,6 +4571,7 @@ class PraxisCrudComponent {
             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 = {
@@ -4534,6 +4590,7 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             };
             const handledInline = await this.surfaceOutlets.tryActivate(payload, surfaceContext);
@@ -4610,6 +4667,7 @@ class PraxisCrudComponent {
             }
             return false;
         }
+        const focusOrigin = this.resolveRuntimeFocusOrigin(runtimeEvent);
         let openPromise;
         try {
             openPromise = Promise.resolve(this.surfaceService.open(payload, {
@@ -4628,6 +4686,7 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             }));
         }
@@ -5340,9 +5399,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: {
@@ -5350,15 +5407,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.'),

package/package.json

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

package/types/praxisui-crud.d.ts

@@ -149,6 +149,8 @@ type CrudActionRuntimeEvent = {
     selectedRows?: Record<string, unknown>[];
     rows?: Record<string, unknown>[];
     resourceIdentity?: MaterializedResourceIdentity | null;
+    /** Ephemeral focus origin provided by a runtime surface, never persisted. */
+    focusOrigin?: HTMLElement;
 };
 type CrudContextAction = {
     action: string;
@@ -285,6 +287,12 @@ declare class PraxisCrudComponent implements OnChanges {
     private extractSelectedRowFromEvent;
     private extractSelectedRowFromBulkAction;
     private extractSelectedRowFromToolbarAction;
+    /**
+     * 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.
+     */
+    private resolveRuntimeFocusOrigin;
     private extractDiscoveryActionConfig;
     private resolveSelectedRowForAction;
     private tryOpenDiscoveredCrudSurface;
@@ -356,6 +364,8 @@ interface CrudLaunchRuntime {
     contextIdentity?: MaterializedResourceIdentity | null;
     /** Active runtime drawer session. It is never persisted in CRUD metadata. */
     surfaceRuntime?: SurfaceDrawerRef | null;
+    /** Stable runtime trigger for restoring focus after a form overlay closes. */
+    focusOrigin?: HTMLElement | null;
 }
 declare class CrudLauncherService {
     private readonly router;