@praxisui/crud 9.0.4-rc.8 → 9.0.4

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.4-rc.8",
+  "version": "9.0.4",
   "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.8",
-    "@praxisui/table": "^9.0.4-rc.8",
-    "@praxisui/core": "^9.0.4-rc.8",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.8",
-    "@praxisui/settings-panel": "^9.0.4-rc.8",
+    "@praxisui/dynamic-form": "^9.0.4",
+    "@praxisui/table": "^9.0.4",
+    "@praxisui/core": "^9.0.4",
+    "@praxisui/dynamic-fields": "^9.0.4",
+    "@praxisui/settings-panel": "^9.0.4",
     "@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.8",
+    "@praxisui/ai": "^9.0.4",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud-drawer-adapter.d.ts

@@ -55,8 +55,10 @@ interface CrudDrawerOpenConfig {
     action: CrudAction;
     metadata: CrudMetadata;
     inputs: Record<string, unknown>;
-    /** Read-only record context for edit drawers. It is never part of form inputs or submit payloads. */
+    /** Read-only record context for existing-record drawers. It is never part of form inputs or submit payloads. */
     resourceIdentity?: MaterializedResourceIdentity | null;
+    /** Read-only task scope for related operations. It is never part of form inputs or submit payloads. */
+    contextIdentity?: MaterializedResourceIdentity | null;
     /**
      * Notifica fechamento do drawer (cancelamento/fechamento externo/resultado finalizado).
      */

package/types/praxisui-crud.d.ts

@@ -1,8 +1,9 @@
+import * as _angular_core from '@angular/core';
+import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, AfterViewInit, Provider, OnDestroy } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
-import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
+import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, SurfaceDrawerRef, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
 export { BackConfig } from '@praxisui/core';
-import * as _angular_core from '@angular/core';
-import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider, AfterViewInit, OnDestroy } from '@angular/core';
+import { TableConfigPersistenceStrategy } from '@praxisui/table';
 import { MatDialogConfig, MatDialogRef, MatDialog } from '@angular/material/dialog';
 export { MAT_DIALOG_DATA as DIALOG_DATA } from '@angular/material/dialog';
 import { ComponentType } from '@angular/cdk/portal';
@@ -148,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;
@@ -170,6 +173,8 @@ declare class PraxisCrudComponent implements OnChanges {
     metadata: CrudMetadata | string;
     crudId: string;
     componentInstanceId?: string;
+    /** Controls whether the CRUD's internal table trusts host input or stored user configuration. */
+    tableConfigPersistenceStrategy: TableConfigPersistenceStrategy;
     context?: Record<string, unknown>;
     enableCustomization: boolean;
     /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
@@ -189,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>;
@@ -199,6 +206,7 @@ declare class PraxisCrudComponent implements OnChanges {
     tableQueryContext: Record<string, unknown> | null;
     tableFilterCriteria: Record<string, unknown>;
     tableCrudContext?: CrudContextValue;
+    readonly openingActionLabel: _angular_core.WritableSignal<string | null>;
     private readonly launcher;
     private readonly http;
     private readonly destroyRef;
@@ -234,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;
@@ -244,6 +253,9 @@ declare class PraxisCrudComponent implements OnChanges {
     onToolbarAction(event: CrudActionRuntimeEvent): Promise<void>;
     ngOnChanges(changes: SimpleChanges): void;
     onAction(action: string, row?: Record<string, unknown>, runtimeEvent?: CrudActionRuntimeEvent): Promise<void>;
+    private resolveTaskScopeIdentity;
+    getOpeningActionStatus(actionLabel: string): string;
+    private resolveOpeningActionLabel;
     private hasExplicitOpenBinding;
     getCurrentTableConfigSnapshot(): TableConfig | null;
     onTableMetadataChange(): void;
@@ -260,6 +272,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private tryHandleCanonicalDeleteAction;
     private tryHandleCanonicalDuplicateDraftAction;
     private refreshTable;
+    private resolveSurfaceRuntime;
     private tryRefreshMaterializedLocalData;
     private isCurrentMaterializedRefresh;
     private resolveMaterializedReadUrl;
@@ -277,11 +290,18 @@ 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;
     private resolveDiscoveredSurfaceCatalog;
     private tryOpenDiscoveredWorkflowAction;
+    private notifySurfaceNavigationFailure;
     private resolveDiscoveredActionCatalog;
     private selectDiscoveredWorkflowAction;
     private resolveProvidedWorkflowAction;
@@ -313,6 +333,8 @@ declare class PraxisCrudComponent implements OnChanges {
     private supportsViewCapability;
     private supportsEditCapability;
     private supportsDeleteCapability;
+    private resolveOperationAvailability;
+    private isCatalogActionAvailable;
     private hasCanonicalOperation;
     private resolveCollectionCapabilitiesHref;
     private resolveCrudResourceIdentity;
@@ -329,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; }; "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';
@@ -338,25 +360,36 @@ interface CrudDrawerResult {
     data?: Record<string, unknown>;
 }
 
+interface CrudLaunchRuntime {
+    capabilities?: ResourceCapabilitySnapshot | null;
+    links?: RestApiLinks | null;
+    resourceIdentity?: MaterializedResourceIdentity | null;
+    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;
     private readonly dialog;
     private readonly storage;
     private readonly global;
     private readonly operationResolver;
+    private readonly logger;
+    private dialogHostPromise?;
+    private nextSurfaceFrameId;
     private readonly drawerAdapter;
     launch(action: CrudAction, row: Record<string, unknown> | undefined, metadata: CrudMetadata, componentKeyId?: string | null, drawerCallbacks?: {
         onClose?: () => void;
         onResult?: (result: CrudDrawerResult) => void;
-    }, runtime?: {
-        capabilities?: ResourceCapabilitySnapshot | null;
-        links?: RestApiLinks | null;
-        resourceIdentity?: MaterializedResourceIdentity | null;
-    }): Promise<{
+    }, runtime?: CrudLaunchRuntime): Promise<{
         mode: FormOpenMode;
         ref?: DialogRef<any>;
     }>;
     resolveOpenMode(action: CrudAction, metadata: CrudMetadata): FormOpenMode;
+    private isLikelyOverlayAction;
+    private loadDialogHost;
     private buildRoute;
     private mapInputs;
     private resolveActionForLaunch;
@@ -379,32 +412,38 @@ declare class CrudLauncherService {
     private normalizeCrudOperationName;
     private isExplicitCrudAction;
     private defaultInferredLayoutPolicy;
+    private buildSurfaceFrameId;
+    private resolveSurfaceFrameTitle;
+    private resolveSurfaceFrameSubtitle;
+    private bindSurfaceFrameLifecycle;
     private mergeCrudOverrides;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CrudLauncherService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<CrudLauncherService>;
 }
 
-declare class DynamicFormDialogHostComponent implements OnInit {
-    dialogRef: DialogRef<DynamicFormDialogHostComponent>;
-    data: any;
+declare class DynamicFormDialogHostComponent implements OnInit, AfterViewInit {
+    dialogRef: DialogRef<DynamicFormDialogHostComponent> | null;
     private dialogService;
     private crud;
     private configStorage;
+    private readonly surfaceRef;
     formComp?: PraxisDynamicForm;
     modal: any;
-    presentation: 'modal' | 'drawer';
+    presentation: 'modal' | 'drawer' | 'surface-frame';
     maximized: boolean;
     private initialSize;
     private readonly initialPosition?;
     private rememberState;
     private stateKey?;
     private backDefaults;
+    private terminalClose;
     private destroyRef;
     private readonly i18n;
     resourcePath?: string;
     resourceId?: string | number;
     initialValue?: Record<string, unknown> | null;
     resourceIdentity: MaterializedResourceIdentity | null;
+    contextIdentity: MaterializedResourceIdentity | null;
     schemaUrl?: string | null;
     submitUrl?: string | null;
     submitMethod?: string | null;
@@ -414,22 +453,33 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     formConfig: FormConfig;
     formActions?: FormConfig['actions'];
     readonly formConfigPersistenceStrategy = "input-first";
+    readonly fieldIconPolicy = "presentation-only";
     mode: 'create' | 'edit' | 'view';
     backConfig?: BackConfig;
     private idField;
+    readonly isSurfaceFrame: boolean;
+    readonly data: any;
     texts: Record<string, string>;
-    constructor(dialogRef: DialogRef<DynamicFormDialogHostComponent>, data: any, dialogService: DialogService, crud: GenericCrudService<any>, configStorage: AsyncConfigStorage);
+    constructor(dialogRef: DialogRef<DynamicFormDialogHostComponent> | null, dialogData: any, dialogService: DialogService, crud: GenericCrudService<any>, configStorage: AsyncConfigStorage, surfaceRef?: SurfaceDrawerRef | null, surfaceContentData?: Readonly<Record<string, unknown>> | null);
+    get resourceIdentityLabel(): string;
+    get showContextIdentity(): boolean;
+    private sameIdentity;
+    private identityLabel;
     private extractInitialValue;
     private resolveFormConfig;
     get dialogTitle(): string;
+    get dialogSubtitle(): string | undefined;
+    get dialogIcon(): string | undefined;
     private resolveActionDialogTitle;
     private resolveResourceTitle;
     private resolveFormActions;
     private resolveLayoutPolicy;
     private resolveSubmitLabel;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     onSave(result: unknown): void;
     onCancel(): void;
+    private canLeaveSurfaceFrame;
     toggleMaximize(initial?: boolean): void;
     private resolveOverlayPane;
     private captureRenderedInitialSize;
@@ -437,7 +487,7 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     private applySavedState;
     private updateHostPosition;
     private resolveMaximizedDrawerPosition;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicFormDialogHostComponent, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicFormDialogHostComponent, [{ optional: true; }, { optional: true; }, null, null, null, { optional: true; }, { optional: true; }]>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicFormDialogHostComponent, "praxis-dynamic-form-dialog-host", never, {}, {}, never, never, true, never>;
 }
 
@@ -677,6 +727,7 @@ interface PraxisCrudWidgetEditorInputs {
     metadata?: CrudMetadata | string | null;
     crudId?: string;
     componentInstanceId?: string;
+    tableConfigPersistenceStrategy?: TableConfigPersistenceStrategy;
     context?: Record<string, unknown>;
     enableCustomization?: boolean;
     authoringCapability?: string | null;