@praxisui/crud 8.0.0-beta.0 → 8.0.0-beta.11

package/README.md

@@ -246,6 +246,13 @@ sequenceDiagram
 5. **Modal e drawer nao sao equivalentes internamente**: o ramo modal usa `DynamicFormDialogHostComponent`; o ramo drawer depende do adapter provido pelo host.
 6. **Save e delete geram refetch automatico da lista**: esse side effect faz parte do contrato atual do shell CRUD.
 
+Nota de fronteira para formularios:
+
+- `@praxisui/crud` nao redefine payload de formulario nem filtra campos locais.
+- Campos locais/transientes pertencem ao contrato de `@praxisui/dynamic-form` via `fieldMetadata[].source`, `fieldMetadata[].transient` e `fieldMetadata[].submitPolicy`.
+- No fluxo modal, `DynamicFormDialogHostComponent` recebe `formSubmit.formData` ja filtrado para persistencia. Valores completos de UI ficam em `formSubmit.rawFormData`.
+- `actions[].form.initialValue` e `inputs` continuam sendo seed/contexto de abertura, nao campos automaticamente persistiveis.
+
 ## Documentacao Tecnica da Lib
 
 - `projects/praxis-crud/docs/host-crud-runtime-and-openmode.md`

package/fesm2022/praxisui-crud.mjs

@@ -3409,7 +3409,7 @@ class PraxisCrudComponent {
     async onAction(action, row, runtimeEvent) {
         try {
             document.activeElement?.blur();
-            const openedByDiscovery = await this.tryOpenDiscoveredCrudSurface(action, row);
+            const openedByDiscovery = await this.tryOpenDiscoveredCrudSurface(action, row, runtimeEvent);
             if (openedByDiscovery) {
                 return;
             }
@@ -3704,17 +3704,27 @@ class PraxisCrudComponent {
     resolveFilterCriteria(meta) {
         return this.isRecord(meta?.filterCriteria) ? { ...meta.filterCriteria } : {};
     }
-    async tryOpenDiscoveredCrudSurface(action, row) {
+    async tryOpenDiscoveredCrudSurface(action, row, runtimeEvent) {
         const normalizedAction = String(action || '').trim().toLowerCase();
-        if (!this.isDiscoveryManagedCrudAction(normalizedAction) || !this.surfaceService) {
+        if (!this.surfaceService) {
             return false;
         }
-        const catalog = await this.resolveDiscoveredSurfaceCatalog(normalizedAction, row);
-        const surface = this.selectSurfaceForCrudAction(normalizedAction, catalog?.surfaces || []);
+        const providedSurface = this.resolveProvidedSurface(normalizedAction, runtimeEvent?.actionConfig);
+        if (!providedSurface && !this.isDiscoveryManagedCrudAction(normalizedAction)) {
+            return false;
+        }
+        const catalog = providedSurface
+            ? null
+            : await this.resolveDiscoveredSurfaceCatalog(normalizedAction, row);
+        const surface = providedSurface || this.selectSurfaceForCrudAction(normalizedAction, catalog?.surfaces || []);
         const resourcePath = String(catalog?.resourcePath || this.resolveResourcePath(this.resolvedMetadata) || '').trim();
-        if (!catalog || !surface || !resourcePath) {
+        if (!surface || !resourcePath) {
             return false;
         }
+        if (surface.availability?.allowed === false) {
+            this.snack.open(translateUnavailableWorkflowMessage(this.i18n, surface.availability), undefined, { duration: 2500 });
+            return true;
+        }
         let payload;
         try {
             payload = this.surfaceOpenAdapter.toPayload(surface, {
@@ -3722,7 +3732,7 @@ class PraxisCrudComponent {
                 resourceId: this.resolveRowResourceId(row),
                 endpointKey: this.resolvedMetadata?.resource?.endpointKey,
                 apiUrlEntry: this.resolveDiscoveryApiEntry(),
-                group: catalog.group ?? null,
+                group: catalog?.group ?? null,
             });
         }
         catch {
@@ -3880,6 +3890,23 @@ class PraxisCrudComponent {
         }
         return candidate;
     }
+    resolveProvidedSurface(action, candidate) {
+        if (!candidate || typeof candidate !== 'object') {
+            return null;
+        }
+        const normalizedId = String(candidate.id || '').trim().toLowerCase();
+        if (!normalizedId || normalizedId !== action) {
+            return null;
+        }
+        const surface = candidate;
+        if (!surface.kind || !surface.scope || !surface.path || !surface.method) {
+            return null;
+        }
+        if (!this.isWritableCrudSurface(surface) && !this.isReadableCrudSurface(surface)) {
+            return null;
+        }
+        return surface;
+    }
     selectSurfaceForCrudAction(action, surfaces) {
         const candidates = surfaces
             .filter((surface) => surface.availability?.allowed !== false)
@@ -4412,7 +4439,7 @@ class PraxisCrudComponent {
         />
       }
     }
-  `, 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", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "enableCustomization", "dense"], outputs: ["rowClick", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "columnReorder", "columnReorderAttempt", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "metadataChange", "loadingStateChange", "collectionLinksChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone"] }] });
+  `, 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", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "enableCustomization", "dense"], outputs: ["rowClick", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "columnReorder", "columnReorderAttempt", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "metadataChange", "loadingStateChange", "collectionLinksChange", "selectionChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisCrudComponent, decorators: [{
             type: Component,
@@ -4505,6 +4532,7 @@ class DynamicFormDialogHostComponent {
     submitMethod;
     apiEndpointKey;
     apiUrlEntry;
+    formActions;
     mode = 'create';
     backConfig;
     idField = 'id';
@@ -4560,6 +4588,7 @@ 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.formActions = this.resolveFormActions();
         // Back config: defaults from metadata/action, overridden by saved per-form config
         const defaults = (this.data.action?.back || this.data.metadata?.defaults?.back) || {};
         this.backDefaults = defaults;
@@ -4616,6 +4645,47 @@ class DynamicFormDialogHostComponent {
         }
         return Object.keys(explicit).length ? explicit : null;
     }
+    resolveFormActions() {
+        if (this.mode === 'view') {
+            return undefined;
+        }
+        const submitLabel = this.resolveSubmitLabel();
+        if (!submitLabel) {
+            return undefined;
+        }
+        return {
+            showSaveButton: true,
+            showCancelButton: false,
+            showResetButton: false,
+            submit: {
+                id: 'submit',
+                type: 'submit',
+                color: 'primary',
+                visible: true,
+                label: submitLabel,
+            },
+        };
+    }
+    resolveSubmitLabel() {
+        const action = this.data.action ?? {};
+        const explicit = stringOrUndefined(action.form?.submitLabel ??
+            action.submitLabel ??
+            action.form?.actions?.submit?.label ??
+            action.form?.actions?.submitButtonLabel);
+        if (explicit) {
+            return explicit;
+        }
+        const actionLabel = stringOrUndefined(action.label);
+        if (this.mode === 'create') {
+            return deriveCreateSubmitLabel(actionLabel);
+        }
+        if (this.mode === 'edit') {
+            return actionLabel && !/^editar\b/i.test(actionLabel)
+                ? actionLabel
+                : 'Salvar alterações';
+        }
+        return undefined;
+    }
     ngOnInit() {
         // Carregar estado salvo (se habilitado)
         if (this.rememberState && this.stateKey) {
@@ -4640,8 +4710,11 @@ class DynamicFormDialogHostComponent {
         }
     }
     onSave(result) {
+        const stage = getFormSubmitStage(result);
+        if (stage === 'before' || stage === 'error') {
+            return;
+        }
         if (this.modal.closeOnSave === false) {
-            // Não fechar: manter aberto e opcionalmente salvar estado atual
             this.saveState();
             return;
         }
@@ -4779,11 +4852,12 @@ class DynamicFormDialogHostComponent {
         [apiUrlEntry]="apiUrlEntry"
         [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
+        [actions]="formActions"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, isInline: true, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.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)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { 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: MatButtonModule }, { kind: "component", type: i2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5$1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "schemaSource", "schemaUrl", "submitUrl", "submitMethod", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "formId", "componentInstanceId", "layout", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError"] }] });
+  `, isInline: true, styles: [":host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}:host([data-density=\"compact\"]){--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}.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)}.dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}.spacer{flex:1}.dialog-content{overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}.dialog-header button.mat-icon-button{color:var(--md-sys-color-on-surface-variant)}.dialog-header button.mat-icon-button:hover{color:var(--md-sys-color-primary);background:var(--md-sys-color-primary-container)}.dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { 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: MatButtonModule }, { kind: "component", type: i2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5$1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "submitUrl", "submitMethod", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "formId", "componentInstanceId", "layout", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: DynamicFormDialogHostComponent, decorators: [{
             type: Component,
@@ -4841,6 +4915,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         [apiUrlEntry]="apiUrlEntry"
         [presentationModeGlobal]="mode === 'view' ? true : null"
         [backConfig]="backConfig"
+        [actions]="formActions"
         (formSubmit)="onSave($event)"
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
@@ -4859,6 +4934,29 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 type: ViewChild,
                 args: [PraxisDynamicForm]
             }] } });
+function getFormSubmitStage(result) {
+    if (!result || typeof result !== 'object' || !('stage' in result)) {
+        return null;
+    }
+    const stage = result.stage;
+    return stage === 'before' || stage === 'after' || stage === 'error'
+        ? stage
+        : null;
+}
+function stringOrUndefined(value) {
+    const text = String(value ?? '').trim();
+    return text || undefined;
+}
+function deriveCreateSubmitLabel(actionLabel) {
+    if (!actionLabel) {
+        return 'Criar';
+    }
+    const match = actionLabel.match(/^(novo|nova|adicionar|incluir|criar)\s+(.+)$/i);
+    if (match?.[2]) {
+        return `Criar ${match[2].trim()}`;
+    }
+    return actionLabel;
+}
 
 var dynamicFormDialogHost_component = /*#__PURE__*/Object.freeze({
     __proto__: null,

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as _praxisui_core from '@praxisui/core';
-import { ApiEndpoint, TableConfig, PraxisDataQueryContext, FormConfig, BackConfig, RowAction, ToolbarAction, ApiUrlEntry, ResourceActionCatalogItem, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, SettingsValueProvider } from '@praxisui/core';
+import { ApiEndpoint, TableConfig, PraxisDataQueryContext, FormConfig, BackConfig, RowAction, ToolbarAction, ApiUrlEntry, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, SettingsValueProvider } from '@praxisui/core';
 export { BackConfig } from '@praxisui/core';
 import * as _angular_core from '@angular/core';
 import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider } from '@angular/core';
@@ -123,7 +123,7 @@ interface CrudValidationContext {
 }
 
 type CrudActionRuntimeEvent = {
-    actionConfig?: ResourceActionCatalogItem | null;
+    actionConfig?: ResourceActionCatalogItem | ResourceSurfaceCatalogItem | null;
 };
 type CrudContextAction = {
     action: string;
@@ -230,6 +230,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private resolveDiscoveredActionCatalog;
     private selectDiscoveredWorkflowAction;
     private resolveProvidedWorkflowAction;
+    private resolveProvidedSurface;
     private selectSurfaceForCrudAction;
     private getPreferredSurfaceIdsForCrudAction;
     private isDiscoveryManagedCrudAction;
@@ -336,12 +337,15 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     submitMethod?: string | null;
     apiEndpointKey?: ApiEndpoint | string | null;
     apiUrlEntry?: ApiUrlEntry | null;
+    formActions?: FormConfig['actions'];
     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 resolveFormActions;
+    private resolveSubmitLabel;
     ngOnInit(): void;
     onSave(result: unknown): void;
     onCancel(): void;

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/crud",
-  "version": "8.0.0-beta.0",
+  "version": "8.0.0-beta.11",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
     "@angular/core": "^20.1.0",
-    "@praxisui/dynamic-form": "^8.0.0-beta.0",
-    "@praxisui/table": "^8.0.0-beta.0",
-    "@praxisui/core": "^8.0.0-beta.0",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.0",
-    "@praxisui/settings-panel": "^8.0.0-beta.0"
+    "@praxisui/dynamic-form": "^8.0.0-beta.11",
+    "@praxisui/table": "^8.0.0-beta.11",
+    "@praxisui/core": "^8.0.0-beta.11",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.11",
+    "@praxisui/settings-panel": "^8.0.0-beta.11"
   },
   "dependencies": {
     "tslib": "^2.3.0"