@praxisui/crud 9.0.0-beta.8 → 9.0.0-beta.81

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.0-beta.8",
+  "version": "9.0.0-beta.81",
   "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.0-beta.8",
-    "@praxisui/table": "^9.0.0-beta.8",
-    "@praxisui/core": "^9.0.0-beta.8",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.8",
-    "@praxisui/settings-panel": "^9.0.0-beta.8",
+    "@praxisui/dynamic-form": "^9.0.0-beta.81",
+    "@praxisui/table": "^9.0.0-beta.81",
+    "@praxisui/core": "^9.0.0-beta.81",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.81",
+    "@praxisui/settings-panel": "^9.0.0-beta.81",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.0-beta.8",
+    "@praxisui/ai": "^9.0.0-beta.81",
     "rxjs": "~7.8.0"
   },
   "dependencies": {
@@ -28,6 +28,7 @@
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "crud",
     "admin",
     "backoffice",
@@ -48,7 +49,10 @@
     "./drawer-adapter": {
       "types": "./types/praxisui-crud-drawer-adapter.d.ts",
       "default": "./fesm2022/praxisui-crud-drawer-adapter.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

package/types/praxisui-crud.d.ts

@@ -1,5 +1,5 @@
 import * as _praxisui_core from '@praxisui/core';
-import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, 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, 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';
@@ -20,14 +20,20 @@ interface DialogConfig<D = any> extends MatDialogConfig<D> {
     disableCloseOnEsc?: boolean;
     /** Density hint consumed by CRUD dialog host chrome */
     density?: 'default' | 'compact';
+    /** Praxis backdrop visual preset */
+    backdropStyle?: 'blur' | 'dim' | 'transparent';
     /** Enable maximize button */
     canMaximize?: boolean;
     /** Persist last dialog size/state for the same form */
     rememberLastState?: boolean;
+    /** Keep the dialog open after a successful form submission */
+    closeOnSave?: boolean;
     /** Start dialog maximized */
     startMaximized?: boolean;
     /** Screen width in px where dialog starts fullscreen */
     fullscreenBreakpoint?: number;
+    /** Viewport inset in px applied while the dialog or drawer is maximized */
+    edgeGap?: number;
 }
 
 declare class DialogService {
@@ -53,6 +59,7 @@ interface CrudActionFormContract {
     apiEndpointKey?: ApiEndpoint | string | null;
     apiUrlEntry?: ApiUrlEntry | null;
     initialValue?: Record<string, unknown> | null;
+    layoutPolicy?: DynamicFormLayoutPolicy | null;
 }
 type CrudActionResolutionMode = 'inferred' | 'explicit';
 type CrudAction = (RowAction | ToolbarAction) & {
@@ -72,8 +79,13 @@ interface CrudDefaults {
 }
 interface CrudResource {
     path: string;
+    schemaPath?: string | null;
     idField?: string | number;
+    title?: string | null;
+    label?: string | null;
+    formTitle?: string | null;
     endpointKey?: ApiEndpoint;
+    apiUrlEntry?: ApiUrlEntry | null;
 }
 interface CrudMetadata {
     component: 'praxis-crud';
@@ -124,7 +136,13 @@ interface CrudValidationContext {
 }
 
 type CrudActionRuntimeEvent = {
-    actionConfig?: ResourceActionCatalogItem | ResourceSurfaceCatalogItem | null;
+    action?: string;
+    actionConfig?: ToolbarAction | ResourceActionCatalogItem | ResourceSurfaceCatalogItem | null;
+    row?: Record<string, unknown>;
+    selectedRow?: Record<string, unknown>;
+    selectedRows?: Record<string, unknown>[];
+    rows?: Record<string, unknown>[];
+    resourceIdentity?: MaterializedResourceIdentity | null;
 };
 type CrudContextAction = {
     action: string;
@@ -149,6 +167,8 @@ declare class PraxisCrudComponent implements OnChanges {
     componentInstanceId?: string;
     context?: Record<string, unknown>;
     enableCustomization: boolean;
+    /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
+    authoringCapability: string | null;
     configureRequested: EventEmitter<void>;
     afterOpen: EventEmitter<{
         mode: FormOpenMode;
@@ -181,6 +201,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private table;
     private readonly storage;
     private readonly settingsPanel;
+    private readonly enterpriseRuntimeContext;
     private readonly snack;
     private readonly dialog;
     private readonly i18n;
@@ -188,8 +209,10 @@ declare class PraxisCrudComponent implements OnChanges {
     private resourceDiscoveryInstance?;
     private actionOpenAdapterInstance?;
     private surfaceOpenAdapterInstance?;
+    private materializedRefreshSequence;
     private readonly global;
     private readonly surfaceService;
+    private readonly surfaceOutlets;
     private readonly componentKeys;
     private readonly route;
     private warnedMissingId;
@@ -199,16 +222,21 @@ declare class PraxisCrudComponent implements OnChanges {
     private lastAppliedResourceIdentity;
     private tableCollectionLinks;
     private collectionCapabilities;
+    private activeAuthoringPanelRef;
+    constructor();
     private collectionCapabilitiesRequestHref;
     private collectionCapabilitiesResolvedHref;
     private collectionCapabilitiesRequestSeq;
     private currentAuthoringDocument?;
+    selectedRow: Record<string, unknown> | null;
     private getResourceDiscovery;
     private getActionOpenAdapter;
     private getSurfaceOpenAdapter;
     onResetPreferences(): void;
     onTableRowClick(event: unknown): void;
     onTableSelectionChange(event: unknown): void;
+    onBulkAction(event: CrudActionRuntimeEvent): Promise<void>;
+    onToolbarAction(event: CrudActionRuntimeEvent): Promise<void>;
     ngOnChanges(changes: SimpleChanges): void;
     onAction(action: string, row?: Record<string, unknown>, runtimeEvent?: CrudActionRuntimeEvent): Promise<void>;
     private hasExplicitOpenBinding;
@@ -225,7 +253,13 @@ declare class PraxisCrudComponent implements OnChanges {
     getEmptyStatePrimaryAction(): string;
     onConfigureRequested(): void;
     private tryHandleCanonicalDeleteAction;
+    private tryHandleCanonicalDuplicateDraftAction;
     private refreshTable;
+    private tryRefreshMaterializedLocalData;
+    private isCurrentMaterializedRefresh;
+    private resolveMaterializedReadUrl;
+    private unwrapRestData;
+    private extractCollectionData;
     private emitTableRuntimeConfigSnapshot;
     private applyResolvedCrudState;
     private assignTableConfigForBinding;
@@ -234,6 +268,12 @@ declare class PraxisCrudComponent implements OnChanges {
     private syncRuntimeBindings;
     private resolveQueryContext;
     private resolveFilterCriteria;
+    private extractRowFromEvent;
+    private extractSelectedRowFromEvent;
+    private extractSelectedRowFromBulkAction;
+    private extractSelectedRowFromToolbarAction;
+    private extractDiscoveryActionConfig;
+    private resolveSelectedRowForAction;
     private tryOpenDiscoveredCrudSurface;
     private resolveDiscoveredSurfaceCatalog;
     private tryOpenDiscoveredWorkflowAction;
@@ -251,8 +291,12 @@ declare class PraxisCrudComponent implements OnChanges {
     private handleDiscoveredSurfaceResult;
     private buildEffectiveTableConfig;
     private isAddLike;
+    private normalizeCrudActionName;
+    private shouldCanonicalizeToolbarCreateAction;
+    private isCreateActionAliasName;
     private buildTableCrudContext;
     private readonly openCrudAuthoringFromTable;
+    isCustomizationAvailable(): boolean;
     private applyCrudAuthoringPayload;
     private buildWidgetPersistencePayload;
     private resolveCreateToolbarAction;
@@ -274,9 +318,12 @@ declare class PraxisCrudComponent implements OnChanges {
     private componentKeyId;
     private warnMissingId;
     private getCrudActionLabel;
+    private ensureCanonicalCollectionEmptyState;
     private tx;
+    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; }; }, { "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; }; "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>;
 }
 
 type CrudDrawerResultType = 'save' | 'delete' | 'close';
@@ -298,6 +345,7 @@ declare class CrudLauncherService {
     }, runtime?: {
         capabilities?: ResourceCapabilitySnapshot | null;
         links?: RestApiLinks | null;
+        resourceIdentity?: MaterializedResourceIdentity | null;
     }): Promise<{
         mode: FormOpenMode;
         ref?: DialogRef<any>;
@@ -306,6 +354,7 @@ declare class CrudLauncherService {
     private buildRoute;
     private mapInputs;
     private resolveActionForLaunch;
+    private resolveSubmitUrlTemplate;
     private resolveActionFormContract;
     resolveRuntimeContract(action: CrudAction, row: Record<string, unknown> | undefined, metadata: CrudMetadata, runtime?: {
         capabilities?: ResourceCapabilitySnapshot | null;
@@ -316,10 +365,14 @@ declare class CrudLauncherService {
         submitMethod?: string | null;
         apiEndpointKey?: unknown;
         apiUrlEntry?: unknown;
+        layoutPolicy?: unknown;
     };
     private buildInferredFormId;
     private isCanonicalCrudAction;
+    private normalizeActionForLaunch;
+    private normalizeCrudOperationName;
     private isExplicitCrudAction;
+    private defaultInferredLayoutPolicy;
     private mergeCrudOverrides;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CrudLauncherService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<CrudLauncherService>;
@@ -333,8 +386,10 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     private configStorage;
     formComp?: PraxisDynamicForm;
     modal: any;
+    presentation: 'modal' | 'drawer';
     maximized: boolean;
     private initialSize;
+    private readonly initialPosition?;
     private rememberState;
     private stateKey?;
     private backDefaults;
@@ -342,19 +397,28 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     resourcePath?: string;
     resourceId?: string | number;
     initialValue?: Record<string, unknown> | null;
+    resourceIdentity: MaterializedResourceIdentity | null;
     schemaUrl?: string | null;
     submitUrl?: string | null;
     submitMethod?: string | null;
     apiEndpointKey?: ApiEndpoint | string | null;
     apiUrlEntry?: ApiUrlEntry | null;
+    layoutPolicy?: DynamicFormLayoutPolicy | null;
+    formConfig: FormConfig;
     formActions?: FormConfig['actions'];
+    readonly formConfigPersistenceStrategy = "input-first";
     mode: 'create' | 'edit' | 'view';
     backConfig?: BackConfig;
     private idField;
     texts: Record<string, string>;
     constructor(dialogRef: DialogRef<DynamicFormDialogHostComponent>, data: any, dialogService: DialogService, crud: GenericCrudService<any>, configStorage: AsyncConfigStorage);
     private extractInitialValue;
+    private resolveFormConfig;
+    get dialogTitle(): string;
+    private resolveActionDialogTitle;
+    private resolveResourceTitle;
     private resolveFormActions;
+    private resolveLayoutPolicy;
     private resolveSubmitLabel;
     ngOnInit(): void;
     onSave(result: unknown): void;
@@ -362,6 +426,8 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     toggleMaximize(initial?: boolean): void;
     private saveState;
     private applySavedState;
+    private updateHostPosition;
+    private resolveMaximizedDrawerPosition;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicFormDialogHostComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicFormDialogHostComponent, "praxis-dynamic-form-dialog-host", never, {}, {}, never, never, true, never>;
 }
@@ -604,6 +670,7 @@ interface PraxisCrudWidgetEditorInputs {
     componentInstanceId?: string;
     context?: Record<string, unknown>;
     enableCustomization?: boolean;
+    authoringCapability?: string | null;
     [key: string]: unknown;
 }
 interface PraxisCrudWidgetEditorValue {