@quadrel-enterprise-ui/framework 20.9.0 → 20.9.1-beta.137.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 advances the form baseline 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 commits the baseline; 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 advances the form baseline so 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 baseline is committed 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 advances the form baseline 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 commits the baseline; 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 advances the form baseline so 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 baseline is committed immediately.
+     *
+     * Errors emitted by the Observable are not caught by the framework — handle them via `catchError` in the handler.
+     */
+    handler: (formValues?: any) => void | Observable<boolean>;
+    /**
+     * @description Optional callback invoked after the framework advances the form baseline 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 commits the baseline; 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('/')
+     * }
+     * ```
      */
-    handler: (formValues?: any) => void;
+    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 advances the form baseline so 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 baseline is committed 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 advances the form baseline 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 commits the baseline; 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;

package/package.json

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