@quadrel-enterprise-ui/framework 20.9.1 → 20.10.0-beta.139.1

package/index.d.ts

@@ -6662,6 +6662,7 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
     hasAutofocus: boolean;
     hasOptions: boolean;
     _value: QdInputValueWithUnit;
+    _displayValue: string;
     control: AbstractControl | QdFormControl<any>;
     private _optionsResolver;
     private _subs;
@@ -9247,6 +9248,28 @@ interface QdPageSaveAction {
      * * This flag is useful in scenarios where form validation is not needed or should be bypassed, but it ensures that only modified forms can be saved.
      */
     hasValidation?: boolean;
+    /**
+     * @description Optional callback invoked after the framework marks the form as saved on a successful save.
+     *
+     * * Runs in the framework's navigation-bypass window, so router navigation from this hook does **not**
+     *   raise the unsaved-changes dialog.
+     *
+     * * For async handlers (returning `Observable<boolean>`), this hook is the **only** race-free place to
+     *   navigate. Side effects in `tap` run *before* the framework marks the form as saved; navigation
+     *   from there would still see a dirty form and trigger the dialog.
+     *
+     * @example
+     * ```ts
+     * save: {
+     *   handler: () => api.update(form.value).pipe(
+     *     tap(result => notifications.success('Saved')),
+     *     map(() => true)
+     *   ),
+     *   onSuccess: () => router.navigateByUrl('/list')
+     * }
+     * ```
+     */
+    onSuccess?: () => void;
 }
 /**
  * @description Interface for the safe draft action.
@@ -9261,9 +9284,39 @@ interface QdPageSaveDraftAction {
         i18n: string;
     };
     /**
-     * @description Handler function that is triggered when the save draft action is executed.
+     * @description Triggered when the save draft action is executed.
+     *
+     * Success criteria:
+     * - If the handler returns an `Observable<boolean>`, only the first emission counts:
+     *   - **true:** success — the framework marks the form as saved (the page is no longer dirty).
+     *   - **false:** failure/cancel — the form stays dirty.
+     * - If the handler returns `void`, the action is treated as instant success and the form is marked as saved immediately.
+     *
+     * Errors emitted by the Observable are not caught by the framework — handle them via `catchError` in the handler.
      */
-    handler: () => void;
+    handler: (formValues?: any) => void | Observable<boolean>;
+    /**
+     * @description Optional callback invoked after the framework marks the form as saved on a successful save draft.
+     *
+     * * Runs in the framework's navigation-bypass window, so router navigation from this hook does **not**
+     *   raise the unsaved-changes dialog.
+     *
+     * * For async handlers (returning `Observable<boolean>`), this hook is the **only** race-free place to
+     *   navigate. Side effects in `tap` run *before* the framework marks the form as saved; navigation
+     *   from there would still see a dirty form and trigger the dialog.
+     *
+     * @example
+     * ```ts
+     * saveDraft: {
+     *   handler: () => api.saveDraft(form.value).pipe(
+     *     tap(result => notifications.success('Draft saved')),
+     *     map(() => true)
+     *   ),
+     *   onSuccess: () => router.navigateByUrl('/drafts')
+     * }
+     * ```
+     */
+    onSuccess?: () => void;
 }
 /**
  * @description Interface for the cancel action, including an optional confirmation message.
@@ -9306,9 +9359,39 @@ interface QdPageCreateSubmitAction {
         i18n: string;
     };
     /**
-     * @description Handler function that is triggered when the submit action is executed.
+     * @description Triggered when the submit action is executed.
+     *
+     * Success criteria:
+     * - If the handler returns an `Observable<boolean>`, only the first emission counts:
+     *   - **true:** success — the framework marks the form as saved (the page is no longer dirty).
+     *   - **false:** failure/cancel — the form stays dirty.
+     * - If the handler returns `void`, the action is treated as instant success and the form is marked as saved immediately.
+     *
+     * Errors emitted by the Observable are not caught by the framework — handle them via `catchError` in the handler.
      */
-    handler: (formValues?: any) => void;
+    handler: (formValues?: any) => void | Observable<boolean>;
+    /**
+     * @description Optional callback invoked after the framework marks the form as saved on a successful submit.
+     *
+     * * Runs in the framework's navigation-bypass window, so router navigation from this hook does **not**
+     *   raise the unsaved-changes dialog.
+     *
+     * * For async handlers (returning `Observable<boolean>`), this hook is the **only** race-free place to
+     *   navigate. Side effects in `tap` run *before* the framework marks the form as saved; navigation
+     *   from there would still see a dirty form and trigger the dialog.
+     *
+     * @example
+     * ```ts
+     * submit: {
+     *   handler: (formValues) => api.create(formValues).pipe(
+     *     tap(result => notifications.success('Created')),
+     *     map(() => true)
+     *   ),
+     *   onSuccess: () => router.navigateByUrl('/')
+     * }
+     * ```
+     */
+    onSuccess?: () => void;
 }
 /**
  * @description Interface for the submit action.
@@ -9323,9 +9406,17 @@ interface QdPageSubmitAction {
         i18n: string;
     };
     /**
-     * @description Handler function that is triggered when the submit action is executed.
+     * @description Triggered when the submit action is executed.
+     *
+     * Success criteria:
+     * - If the handler returns an `Observable<boolean>`, only the first emission counts:
+     *   - **true:** success — the framework marks the form as saved (the page is no longer dirty).
+     *   - **false:** failure/cancel — the form stays dirty.
+     * - If the handler returns `void`, the action is treated as instant success and the form is marked as saved immediately.
+     *
+     * Errors emitted by the Observable are not caught by the framework — handle them via `catchError` in the handler.
      */
-    handler: (formValues?: any) => void;
+    handler: (formValues?: any) => void | Observable<boolean>;
     /**
      * @description By default, the visibility of the submit button depends on the page type and the operation mode.
      * To completely hide the submit button, you can set this isHidden flag.
@@ -9333,6 +9424,28 @@ interface QdPageSubmitAction {
      * @default false
      */
     isHidden?: boolean;
+    /**
+     * @description Optional callback invoked after the framework marks the form as saved on a successful submit.
+     *
+     * * Runs in the framework's navigation-bypass window, so router navigation from this hook does **not**
+     *   raise the unsaved-changes dialog.
+     *
+     * * For async handlers (returning `Observable<boolean>`), this hook is the **only** race-free place to
+     *   navigate. Side effects in `tap` run *before* the framework marks the form as saved; navigation
+     *   from there would still see a dirty form and trigger the dialog.
+     *
+     * @example
+     * ```ts
+     * submit: {
+     *   handler: (formValues) => api.update(formValues).pipe(
+     *     tap(result => notifications.success('Updated')),
+     *     map(() => true)
+     *   ),
+     *   onSuccess: () => router.navigateByUrl('/list')
+     * }
+     * ```
+     */
+    onSuccess?: () => void;
 }
 /**
  * @description Interface for the edit action.
@@ -12874,7 +12987,15 @@ declare class QdSectionComponent implements OnInit, AfterViewInit, OnChanges, On
  *         handler: () => handleCancel()
  *       },
  *       save: {
- *         handler: (formValues) => handleSave(formValues)
+ *         handler: () => saveApi.save(form.value).pipe(
+ *           tap(result => notifications.success('Saved')),
+ *           map(() => true),
+ *           catchError(err => {
+ *             notifications.showError(err);
+ *             return of(false);
+ *           })
+ *         ),
+ *         onSuccess: () => router.navigate(['/overview'])
  *       }
  *     }
  *   };
@@ -12992,7 +13113,8 @@ declare class QdSectionComponent implements OnInit, AfterViewInit, OnChanges, On
  *   pageType: 'create',
  *   pageTypeConfig: {
  *     submit: {
- *       handler: (formValues) => handleSubmit(formValues)
+ *       handler: (formValues) => createApi.create(formValues).pipe(map(() => true)),
+ *       onSuccess: () => router.navigate(['/items'])
  *     }
  *   }
  * };
@@ -13085,7 +13207,14 @@ declare class QdSectionComponent implements OnInit, AfterViewInit, OnChanges, On
  *       handler: () => handleCancel()
  *     },
  *     save: {
- *       handler: (formValues) => handleSave(formValues)
+ *       handler: (formValues) => saveApi.save(formValues).pipe(
+ *         map(() => true),
+ *         catchError(err => {
+ *           notifications.showError(err);
+ *           return of(false);
+ *         })
+ *       ),
+ *       onSuccess: () => router.navigate(['/overview'])
  *     }
  *   }
  * };
@@ -13197,7 +13326,7 @@ declare class QdPageComponent<T extends object> implements OnInit, OnChanges, Af
     private handleCancelActionWithFormChanges;
     private initSaveDraftFooterAction;
     private updateInspectPageOperationMode;
-    private generateFooterActionHandler;
+    private generateCommitActionHandler;
     private setupCancelConfirmation;
     private initSubmitValidation;
     private setupPageDialogCloseContract;
@@ -13324,6 +13453,7 @@ declare class QdPageStoreService<T extends object> {
 declare class QdPageObjectHeaderComponent<T extends object> implements OnInit, OnChanges, OnDestroy {
     private pageObjectResolver;
     private formGroupManagerService;
+    private navigationInterceptor;
     private dialogComponent;
     private dialog;
     private confirmationDialogService;
@@ -17014,17 +17144,35 @@ interface QdQuickEditConfig<T extends string> {
      */
     canAdd?: boolean;
     /**
-     * @description An optional confirmation message displayed in a dialog before a row is removed via the built-in remove button.
+     * @description Enables a confirmation dialog before a row is removed via the built-in remove button.
      *
-     * When provided, a confirmation dialog is shown to the user. The row is only removed if the user confirms.
-     * If not provided, the row is removed directly.
+     * When set to `true`, a confirmation dialog with a framework default message is shown. The row is only removed if the user confirms.
      * Only applies when `canAdd` is true and the remove button is visible.
      *
+     * @default false
+     *
+     * @example
+     * ```ts
+     * {
+     *   columns: [...],
+     *   canAdd: true,
+     *   hasRemoveConfirmation: true
+     * }
+     * ```
+     */
+    hasRemoveConfirmation?: boolean;
+    /**
+     * @description Overrides the default message of the remove confirmation dialog.
+     *
+     * When set, the confirmation dialog is shown with the provided message (setting this also enables the dialog for backward compatibility).
+     * If omitted, the framework default message is shown when the dialog is enabled via `hasRemoveConfirmation`.
+     *
      * @example
      * ```ts
      * {
      *   columns: [...],
      *   canAdd: true,
+     *   hasRemoveConfirmation: true,
      *   removeConfirmationMessage: { i18n: 'i18n.app.remove.entry.confirmation' }
      * }
      * ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadrel-enterprise-ui/framework",
-  "version": "20.9.1",
+  "version": "20.10.0-beta.139.1",
   "exports": {
     "./jest-preset": "./jest-preset.js",
     "./package.json": {

package/src/assets/i18n/de.json

@@ -171,5 +171,6 @@
   "i18n.qd.section.toolbar.defaultAction": "Aktion",
   "i18n.qd.quick.edit.submitButtonLabel": "Speichern",
   "i18n.qd.quick.edit.createButtonLabel": "Hinzufügen",
-  "i18n.qd.quick.edit.removeButtonLabel": "Löschen"
+  "i18n.qd.quick.edit.removeButtonLabel": "Löschen",
+  "i18n.qd.quick.edit.removeConfirmation.message": "Möchten Sie diesen Eintrag wirklich löschen?"
 }

package/src/assets/i18n/en.json

@@ -171,5 +171,6 @@
   "i18n.qd.quick.edit.submitButtonLabel": "Save",
   "i18n.qd.quick.edit.createButtonLabel": "Add",
   "i18n.qd.quick.edit.removeButtonLabel": "Remove",
+  "i18n.qd.quick.edit.removeConfirmation.message": "Are you sure you want to remove this entry?",
   "i18n.contact.tag": "AEO"
 }

package/src/assets/i18n/fr.json

@@ -171,5 +171,6 @@
   "i18n.qd.quick.edit.submitButtonLabel": "Enregistrer",
   "i18n.qd.quick.edit.createButtonLabel": "Ajouter",
   "i18n.qd.quick.edit.removeButtonLabel": "Retirer",
+  "i18n.qd.quick.edit.removeConfirmation.message": "Voulez-vous vraiment retirer cette entrée ?",
   "i18n.contact.tag": "AEO"
 }

package/src/assets/i18n/it.json

@@ -171,6 +171,7 @@
   "i18n.qd.quick.edit.submitButtonLabel": "Trasferire",
   "i18n.qd.quick.edit.createButtonLabel": "Aggiungere",
   "i18n.qd.quick.edit.removeButtonLabel": "Eliminare",
+  "i18n.qd.quick.edit.removeConfirmation.message": "Vuoi davvero eliminare questa voce?",
   "i18n.contact.tag": "AEO",
   "i18n.qd.page.footer.saveDraft": "Entwurf speichern"
 }