@luigi-project/core-modular 0.0.7-dev.20260510109 → 0.0.7-dev.202605110108

package/package.json

@@ -18,5 +18,5 @@
     "micro-frontends",
     "microfrontends"
   ],
-  "version": "0.0.7-dev.20260510109"
+  "version": "0.0.7-dev.202605110108"
 }

package/services/dirty-status.service.d.ts

@@ -1,4 +1,6 @@
+import { Luigi } from '../core-api/luigi';
 export declare class DirtyStatusService {
+    private luigi;
     unsavedChanges: {
         isDirty?: boolean;
         persistUrl?: string | null;
@@ -8,7 +10,7 @@ export declare class DirtyStatusService {
      * Initializes the `unsavedChanges` property with default values.
      * Sets `isDirty` to `false` and `persistUrl` to `null`, indicating that there are no unsaved changes initially.
      */
-    constructor();
+    constructor(luigi: Luigi);
     /**
      * Updates the dirty status of a given source and manages the set of unsaved changes.
      *
@@ -38,4 +40,6 @@ export declare class DirtyStatusService {
      * @returns {boolean} `true` if there are unsaved changes, otherwise `false`.
      */
     readDirtyStatus(): boolean;
+    getUnsavedChangesModalPromise(source?: any): Promise<void>;
+    shouldShowUnsavedChangesModal(source?: any): boolean;
 }

package/services/modal.service.d.ts

@@ -49,4 +49,5 @@ export declare class ModalService {
      * Removes the last modal from the stack.
      */
     removeLastModalFromStack(): void;
+    closeModalsWithDirtyCheck(): Promise<boolean>;
 }

package/services/navigation.service.d.ts

@@ -26,7 +26,7 @@ export declare class NavigationService {
     getTruncatedChildren(children: Node[]): Node[];
     applyNavGroups(items: NavItem[]): NavItem[];
     getLeftNavData(path: string, pData?: PathData): Promise<LeftNavData>;
-    navItemClick(node: Node, pathData?: PathData): void;
+    navItemClick(node: Node, pathData?: PathData): Promise<void>;
     getTopNavData(path: string, pData?: PathData): Promise<TopNavData>;
     getParentNode(node: Node | undefined, pathData: PathData): Node | undefined;
     getAppSwitcherData(appSwitcherData: AppSwitcher, headerSettings: any): AppSwitcher | undefined;

package/services/preloading.service.d.ts

@@ -0,0 +1,58 @@
+import { Luigi } from '../core-api/luigi';
+import { ViewGroupSettings } from '../types/navigation';
+/**
+ * Service responsible for preloading view group containers in the background.
+ *
+ * Preloading creates hidden luigi-container elements for configured view groups
+ * so that navigating to those groups later is near-instant (the MFE is already initialized).
+ * The service adapts its batch size dynamically based on observed MFE load times.
+ */
+export declare class PreloadingService {
+    private luigi;
+    private preloadBatchSize;
+    shouldPreload: boolean;
+    constructor(luigi: Luigi);
+    /**
+     * Preloads view group containers based on the `navigation.viewGroupSettings` configuration.
+     * Skips view groups that already have a container in the DOM or are currently being preloaded.
+     *
+     * @param batchSize - Maximum number of view groups to preload in this cycle (default: 3).
+     * @param backgroundMfeOnly - If true, only preloads view groups with `loadOnStartup: true`.
+     *   Used during application init to load critical MFEs without competing with the main navigation.
+     */
+    preloadViewGroups(batchSize?: number, backgroundMfeOnly?: boolean): void;
+    /**
+     * Creates a hidden luigi-container for the given view group and appends it to the DOM.
+     * The container loads the `preloadUrl` MFE in the background with `display: none`.
+     *
+     * @param settings - The view group settings containing the preloadUrl.
+     * @param name - The view group name (used as identifier on the container).
+     * @param containerWrapper - The DOM element to append the hidden container to.
+     */
+    preloadContainerOnBackground(settings: ViewGroupSettings, name: string, containerWrapper: HTMLElement): void;
+    /**
+     * Schedules a preload cycle. Uses a flag-based mechanism to skip the very first invocation
+     * and only trigger preloading from the second call onwards.
+     *
+     * @param backgroundMfeOnly - If true, only `loadOnStartup` view groups are preloaded.
+     *   Passed through to `preloadViewGroups`.
+     */
+    preload(backgroundMfeOnly?: boolean): void;
+    /**
+     * Called when a preloaded container has finished initializing (INITIALIZED event).
+     * Measures load time and adapts the batch size for subsequent preload cycles:
+     * - < 500ms  → batchSize 3 (fast connection)
+     * - 500–1000ms → batchSize 2
+     * - > 1000ms → batchSize 1 (slow, be conservative)
+     *
+     * Also schedules clearing the `_luigiPreloading` flag after a short delay,
+     * freeing the container for the next preload cycle.
+     *
+     * @param container - The container element that finished loading.
+     */
+    viewGroupLoaded(container: any): void;
+    /**
+     * Returns all containers in the wrapper that are currently in a preloading state.
+     */
+    private getPreloadingContainers;
+}

package/services/routing.service.d.ts

@@ -2,9 +2,11 @@ import { Luigi } from '../core-api/luigi';
 import { Route } from '../types/routing';
 import { ModalSettings, Node, PathData } from '../types/navigation';
 import { NavigationService } from './navigation.service';
+import { DirtyStatusService } from './dirty-status.service';
 export declare class RoutingService {
     private luigi;
     navigationService?: NavigationService;
+    dirtyStatusService?: DirtyStatusService;
     previousNode: Node | undefined;
     currentRoute?: Route;
     modalSettings?: ModalSettings;

package/types/connector.d.ts

@@ -6,7 +6,7 @@ export interface LuigiConnector {
     renderLeftNav(data: LeftNavData): void;
     getContainerWrapper(): HTMLElement;
     renderModal(content: HTMLElement, modalSettings: ModalSettings, onCloseCallback?: () => void, onCloseRequest?: () => void): any;
-    renderDrawer(content: HTMLElement, modalSettings: DrawerSettings, onCloseCallback?: () => void): any;
+    renderDrawer(content: HTMLElement, drawerSettings: DrawerSettings, onCloseCallback?: () => void, onCloseRequest?: () => void): any;
     renderTabNav(data: TabNavData): void;
     renderBreadcrumbs(data: BreadcrumbData): void;
     renderAlert(alertSettings: AlertSettings, alertHandler: AlertHandler): void;

package/types/navigation.d.ts

@@ -5,7 +5,7 @@ export interface TopNavData {
     productSwitcher?: ProductSwitcher;
     profile?: ProfileSettings;
     appSwitcher?: AppSwitcher;
-    navClick?: (item: NavItem) => void;
+    navClick?: (item: NavItem) => Promise<void>;
 }
 export interface AppSwitcher {
     showMainAppEntry?: boolean;
@@ -63,7 +63,7 @@ export interface LeftNavData {
     items: NavItem[];
     basePath: string;
     sideNavFooterText?: string;
-    navClick?: (item: NavItem) => void;
+    navClick?: (item: NavItem) => Promise<void>;
 }
 export interface PathData {
     context?: Record<string, any>;
@@ -168,7 +168,7 @@ export interface TabNavData {
     selectedNode?: any;
     items?: NavItem[];
     basePath?: string;
-    navClick?: (item: NavItem) => void;
+    navClick?: (item: NavItem) => Promise<void>;
 }
 export interface BreadcrumbData {
     basePath?: string;
@@ -465,4 +465,8 @@ export interface TitleResolver {
     /** @internal runtime cache – not user-configured */
     _cache?: TitleResolverCache;
 }
+export interface ViewGroupSettings {
+    preloadUrl?: string;
+    loadOnStartup?: boolean;
+}
 export type HistoryMethod = 'pushState' | 'replaceState';