@openmfp/ngx 0.12.6 → 0.12.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmfp/ngx",
-  "version": "0.12.6",
+  "version": "0.12.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openmfp/webcomponents.git"

package/types/openmfp-ngx.d.ts

@@ -441,6 +441,17 @@ declare class Dashboard implements OnInit, OnDestroy {
     editMode: _angular_core.WritableSignal<boolean>;
     compactToolbar: _angular_core.WritableSignal<boolean>;
     toolbarMenuOpen: _angular_core.WritableSignal<boolean>;
+    /** True once the user has dragged/resized any grid item while in edit mode. */
+    private gridDirty;
+    /** JSON snapshots of sections/cards taken on entering edit mode, used to detect changes. */
+    private sectionsSnapshotJson;
+    private cardsSnapshotJson;
+    /**
+     * True when the user is in edit mode AND has made any change (sections/cards
+     * mutated, or grid items moved/resized). Resets when entering edit mode and
+     * after save/cancel.
+     */
+    hasUnsavedChanges: _angular_core.Signal<boolean>;
     private sectionsSnapshot;
     private cardsSnapshot;
     private gridStackItems;
@@ -453,6 +464,12 @@ declare class Dashboard implements OnInit, OnDestroy {
     protected safeDescription: _angular_core.Signal<SafeHtml | null>;
     protected gridOptions: _angular_core.Signal<GridStackOptions>;
     cardDialogOpen: _angular_core.WritableSignal<boolean>;
+    discardDialogOpen: _angular_core.WritableSignal<boolean>;
+    unsavedNavDialogOpen: _angular_core.WritableSignal<boolean>;
+    /** Callback that resumes the intercepted navigation once the user resolves the dialog. */
+    private pendingNavigation;
+    /** beforeunload handler kept on instance so add/removeEventListener pair up. */
+    private readonly beforeUnloadHandler;
     customActions: _angular_core.Signal<ButtonSettings[]>;
     addedCardsIds: _angular_core.Signal<Set<string>>;
     editViewButton: _angular_core.Signal<{
@@ -488,6 +505,48 @@ declare class Dashboard implements OnInit, OnDestroy {
     enterEditMode(): void;
     saveEdit(): void;
     cancelEdit(): void;
+    /**
+     * Confirms abandoning unsaved edit-mode changes: closes the discard popup
+     * and reverts sections/cards to the snapshot taken on entering edit mode.
+     */
+    confirmDiscard(): void;
+    /**
+     * Cancels the discard popup and keeps the user in edit mode with their
+     * pending changes intact.
+     */
+    cancelDiscard(): void;
+    /**
+     * Public framework-agnostic navigation guard. Consumer apps (Angular Router
+     * CanDeactivate guard, Luigi navigation listener, plain `<a>` click handler,
+     * window history listener — anything) call this before performing their
+     * navigation:
+     *
+     *   if (dashboard.requestNavigation(() => router.navigateByUrl(target))) {
+     *     // already navigated synchronously — clean state
+     *   } else {
+     *     // dashboard popped the unsaved-changes dialog; the navigation will
+     *     // resume from the user's choice (Save → proceed, Discard → proceed,
+     *     // Cancel → drop the request entirely).
+     *   }
+     *
+     * Returns `true` when navigation may proceed immediately (no unsaved
+     * changes — `proceed` was invoked synchronously). Returns `false` when the
+     * dialog has been opened and the caller must NOT navigate; the dashboard
+     * will run the callback later if the user picks Save or Discard.
+     *
+     * If a previous navigation is already pending, that one is dropped in
+     * favour of the new request — Cancel always means "stay here", so losing
+     * the older queued navigation is the correct outcome.
+     */
+    requestNavigation(proceed: () => void): boolean;
+    /** Save → persist changes, close the dialog, then resume navigation. */
+    onUnsavedNavSave(): void;
+    /** Discard → revert to snapshot, close the dialog, then resume navigation. */
+    onUnsavedNavDiscard(): void;
+    /** Cancel → drop the queued navigation and stay in edit mode. */
+    onUnsavedNavCancel(): void;
+    private runPendingNavigation;
+    private discardEdit;
     removeSection(id: string): void;
     removeCard(id: string): void;
     openCardPanel(): void;
@@ -503,6 +562,7 @@ declare class Dashboard implements OnInit, OnDestroy {
 }
 
 declare class EditCardsDialog {
+    private readonly host;
     availableCards: _angular_core.InputSignal<CardConfig[]>;
     addedCardsIds: _angular_core.InputSignal<Set<string>>;
     open: _angular_core.InputSignal<boolean>;
@@ -514,11 +574,51 @@ declare class EditCardsDialog {
     selectedIds: _angular_core.WritableSignal<Set<string>>;
     constructor();
     toggle(id: string): void;
+    /**
+     * Tab moves focus across the switches directly, skipping the wrapping
+     * ui5-li-custom rows. Past the last switch Tab goes to the first footer
+     * button; before the first switch Shift+Tab goes to the last footer button.
+     * The dialog's native focus trap takes care of cycling from the buttons
+     * back into the list.
+     */
+    onSwitchKeydown(event: KeyboardEvent, _id: string): void;
     confirmSave(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EditCardsDialog, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EditCardsDialog, "mfp-edit-cards-dialog", never, { "availableCards": { "alias": "availableCards"; "required": false; "isSignal": true; }; "addedCardsIds": { "alias": "addedCardsIds"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "confirm": "confirm"; "cancelled": "cancelled"; }, never, never, true, never>;
 }
 
+/**
+ * Confirmation popup shown when the user tries to abandon edit mode while
+ * there are unsaved dashboard changes. Emits `confirm` when the user accepts
+ * the discard, `cancelled` when they back out.
+ */
+declare class DiscardChangesDialog {
+    open: _angular_core.InputSignal<boolean>;
+    readonly confirm: _angular_core.OutputEmitterRef<void>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DiscardChangesDialog, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DiscardChangesDialog, "mfp-discard-changes-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "confirm": "confirm"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+/**
+ * Confirmation popup shown when the user attempts to navigate away from the
+ * dashboard while there are unsaved edit-mode changes. The host (the
+ * dashboard, an Angular CanDeactivate guard, a Luigi navigation listener,
+ * etc.) is responsible for routing its intercepted navigation through this
+ * dialog and acting on the emitted decision:
+ *  - `save`      → persist changes, then proceed with navigation
+ *  - `discard`   → revert changes, then proceed with navigation
+ *  - `cancelled` → abort navigation, stay on the page
+ */
+declare class UnsavedChangesDialog {
+    open: _angular_core.InputSignal<boolean>;
+    readonly save: _angular_core.OutputEmitterRef<void>;
+    readonly discard: _angular_core.OutputEmitterRef<void>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UnsavedChangesDialog, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UnsavedChangesDialog, "mfp-unsaved-changes-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "save": "save"; "discard": "discard"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
 declare class DashboardCard {
     card: _angular_core.InputSignal<CardConfig>;
     editMode: _angular_core.InputSignal<boolean>;
@@ -1183,5 +1283,5 @@ declare class WhatsNew {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<WhatsNew, "mfp-whats-new", never, {}, {}, never, never, true, never>;
 }
 
-export { BooleanValue, CARD_TYPES, Dashboard, DashboardCard, DashboardSection, DeclarativeForm, DeclarativeTable, DeclarativeTableCard, EditCardsDialog, Favorites, LinkValue, ResourceField, SecretValue, ServiceStatusCard, TagListValue, VisitedServiceCard, WhatsNew };
+export { BooleanValue, CARD_TYPES, Dashboard, DashboardCard, DashboardSection, DeclarativeForm, DeclarativeTable, DeclarativeTableCard, DiscardChangesDialog, EditCardsDialog, Favorites, LinkValue, ResourceField, SecretValue, ServiceStatusCard, TagListValue, UnsavedChangesDialog, VisitedServiceCard, WhatsNew };
 export type { ButtonSettings, CardConfig, CardsType, CssRule, CssRuleCondition, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableConfig, TableFieldDefinition, TransformType, UiSettings };