@praxisui/crud 9.0.4-rc.36 → 9.0.4-rc.38

package/README.md

@@ -103,7 +103,7 @@ It emits:
 - `configureRequested`
 - `afterOpen`, `afterClose`, `afterSave`, `afterDelete`
 - `error`
-- `rowClick`, `selectionChange`
+- `rowClick`, `rowAction`, `selectionChange`. `rowAction` preserves the canonical table envelope (`row`, `action`, `resourceIdentity`) so a governed composition can update task context without forcing visual row selection.
 - `tableRuntimeConfigChange`
 - `crudAuthoringDocumentApplied`, `crudAuthoringDocumentSaved`
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-08T10:35:56.871Z",
+  "generatedAt": "2026-08-10T00:53:13.101Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "9.0.4-rc.36",
+  "packageVersion": "9.0.4-rc.38",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -130,6 +130,12 @@
           "required": false,
           "description": "Encaminha o clique de linha da tabela interna para composição master-detail e seleção local."
         },
+        {
+          "name": "rowAction",
+          "type": "CrudActionRuntimeEvent",
+          "required": false,
+          "description": "Encaminha a ação contextual da linha com row, action e resourceIdentity para composição governada."
+        },
         {
           "name": "selectionChange",
           "type": "unknown",
@@ -7218,9 +7224,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - crudId (string)\n  - componentInstanceId (string)\n  - tableConfigPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - rowClick ({ row: unknown; index: number })\n  - selectionChange (unknown)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
+          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - crudId (string)\n  - componentInstanceId (string)\n  - tableConfigPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - rowClick ({ row: unknown; index: number })\n  - rowAction (CrudActionRuntimeEvent)\n  - selectionChange (unknown)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
           "sourcePointer": "projects/praxis-crud/src/lib/praxis-crud.metadata.ts",
-          "contentHash": "a9d744b92ff6f475de4d870e57bc963200a7b68688a8ea5159cc02496a8967be",
+          "contentHash": "5f18e01c2da358f033eb9b8ee4616dac8a348addc3ce3e56bcb077b094c13300",
           "sourceKind": "component_definition",
           "sourceId": "praxis-crud",
           "corpusVersion": "1.0.0"

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',
@@ -3764,6 +3807,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();
@@ -3834,6 +3879,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));
@@ -4006,6 +4055,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 +4517,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'
@@ -4509,6 +4570,7 @@ class PraxisCrudComponent {
                 presentation: 'drawer',
                 title: surface.title,
                 subtitle: surface.description ?? undefined,
+                parentIdentity: runtimeEvent?.resourceIdentity ?? null,
             });
         }
         catch (error) {
@@ -4516,6 +4578,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 +4597,7 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             };
             const handledInline = await this.surfaceOutlets.tryActivate(payload, surfaceContext);
@@ -4610,6 +4674,7 @@ class PraxisCrudComponent {
             }
             return false;
         }
+        const focusOrigin = this.resolveRuntimeFocusOrigin(runtimeEvent);
         let openPromise;
         try {
             openPromise = Promise.resolve(this.surfaceService.open(payload, {
@@ -4628,6 +4693,7 @@ class PraxisCrudComponent {
                         action: normalizedAction,
                         resourcePath,
                     },
+                    ...(focusOrigin ? { focusOrigin } : {}),
                 },
             }));
         }
@@ -5383,7 +5449,7 @@ 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", tableConfigPersistenceStrategy: "tableConfigPersistenceStrategy", 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: `
@@ -5408,7 +5474,7 @@ class PraxisCrudComponent {
           [authoringCapability]="authoringCapability"
           (rowClick)="onTableRowClick($event)"
           (selectionChange)="onTableSelectionChange($event)"
-          (rowAction)="onAction($event.action, $event.row, $event)"
+          (rowAction)="onTableRowAction($event)"
           (toolbarAction)="onToolbarAction($event)"
           (bulkAction)="onBulkAction($event)"
           (collectionLinksChange)="onCollectionLinksChange($event)"
@@ -5456,7 +5522,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           [authoringCapability]="authoringCapability"
           (rowClick)="onTableRowClick($event)"
           (selectionChange)="onTableSelectionChange($event)"
-          (rowAction)="onAction($event.action, $event.row, $event)"
+          (rowAction)="onTableRowAction($event)"
           (toolbarAction)="onToolbarAction($event)"
           (bulkAction)="onBulkAction($event)"
           (collectionLinksChange)="onCollectionLinksChange($event)"
@@ -5506,6 +5572,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Output
             }], rowClick: [{
                 type: Output
+            }], rowAction: [{
+                type: Output
             }], selectionChange: [{
                 type: Output
             }], tableRuntimeConfigChange: [{
@@ -6625,6 +6693,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',

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.4-rc.36",
+  "version": "9.0.4-rc.38",
   "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.36",
-    "@praxisui/table": "^9.0.4-rc.36",
-    "@praxisui/core": "^9.0.4-rc.36",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.36",
-    "@praxisui/settings-panel": "^9.0.4-rc.36",
+    "@praxisui/dynamic-form": "^9.0.4-rc.38",
+    "@praxisui/table": "^9.0.4-rc.38",
+    "@praxisui/core": "^9.0.4-rc.38",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.38",
+    "@praxisui/settings-panel": "^9.0.4-rc.38",
     "@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.36",
+    "@praxisui/ai": "^9.0.4-rc.38",
     "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;
@@ -192,6 +194,8 @@ declare class PraxisCrudComponent implements OnChanges {
     }>;
     error: EventEmitter<unknown>;
     rowClick: EventEmitter<unknown>;
+    /** Emits the canonical table row-action envelope before the CRUD handles its surface/action. */
+    rowAction: EventEmitter<CrudActionRuntimeEvent>;
     selectionChange: EventEmitter<unknown>;
     tableRuntimeConfigChange: EventEmitter<_praxisui_core.TableConfigModern>;
     crudAuthoringDocumentApplied: EventEmitter<CrudAuthoringWidgetPersistenceEvent>;
@@ -238,6 +242,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private collectionCapabilitiesRequestSeq;
     private currentAuthoringDocument?;
     selectedRow: Record<string, unknown> | null;
+    onTableRowAction(event: CrudActionRuntimeEvent): void;
     private getResourceDiscovery;
     private getActionOpenAdapter;
     private getSurfaceOpenAdapter;
@@ -285,6 +290,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;
@@ -340,7 +351,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private txWithParams;
     private interpolateTranslationParams;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisCrudComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudComponent, "praxis-crud", never, { "metadata": { "alias": "metadata"; "required": true; }; "crudId": { "alias": "crudId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "tableConfigPersistenceStrategy": { "alias": "tableConfigPersistenceStrategy"; "required": false; }; "context": { "alias": "context"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapability": { "alias": "authoringCapability"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; "crudAuthoringDocumentApplied": "crudAuthoringDocumentApplied"; "crudAuthoringDocumentSaved": "crudAuthoringDocumentSaved"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudComponent, "praxis-crud", never, { "metadata": { "alias": "metadata"; "required": true; }; "crudId": { "alias": "crudId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "tableConfigPersistenceStrategy": { "alias": "tableConfigPersistenceStrategy"; "required": false; }; "context": { "alias": "context"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapability": { "alias": "authoringCapability"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; "rowClick": "rowClick"; "rowAction": "rowAction"; "selectionChange": "selectionChange"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; "crudAuthoringDocumentApplied": "crudAuthoringDocumentApplied"; "crudAuthoringDocumentSaved": "crudAuthoringDocumentSaved"; }, never, never, true, never>;
 }
 
 type CrudDrawerResultType = 'save' | 'delete' | 'close';
@@ -356,6 +367,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;