@luigi-project/core-modular 0.0.20-dev.202610270048 → 0.0.20-dev.202610271157

package/package.json

@@ -18,5 +18,5 @@
     "micro-frontends",
     "microfrontends"
   ],
-  "version": "0.0.20-dev.202610270048"
+  "version": "0.0.20-dev.202610271157"
 }

package/types/connector.d.ts

@@ -218,11 +218,20 @@ export interface LuigiConnector {
     /**
      * Open the user-settings dialog.
      *
-     * Core invokes `dialogSettings.renderMicroFrontendContainer(viewUrl, groupKey)`
-     * (which it installs before calling this method) to mount per-group MFEs
-     * inside the dialog, and `dialogSettings.onCloseCallback(stored)` when the
-     * dialog closes — the connector is responsible for calling both at the
-     * appropriate moments.
+     * Core installs two hooks on `dialogSettings` before calling this method:
+     * `dialogSettings.renderMicroFrontendContainer(groupConfig, groupKey)` and
+     * `dialogSettings.onCloseCallback(stored)`. The connector is responsible for
+     * invoking both at the appropriate moments.
+     *
+     * The head calls `renderMicroFrontendContainer(groupConfig, groupKey)` **when a
+     * group becomes active** (selected/visible) and mounts the returned element
+     * into the group's content area. Core owns the per-group cache — a repeated
+     * call for the same group returns the already created container — so the MFE's
+     * init handshake fires once per group on activation (not at dialog-open),
+     * matching legacy core, and the head needs no cache of its own. The head does
+     * the same for the initially selected group right after opening, since no
+     * selection-change fires for it. For a group without a `viewUrl` (native
+     * settings form) the head renders its own controls and does not call this.
      *
      * @param dialogSettings dialog header, save/dismiss button labels, plus the
      *   two core-installed hooks (`renderMicroFrontendContainer`,

package/types/navigation.d.ts

@@ -59,7 +59,7 @@ export interface ProfileSettings {
     items?: ProfileItem[];
     staticUserInfoFn?: () => Promise<UserInfo>;
     onUserInfoUpdate: (fn: (uInfo: UserInfo) => void) => void;
-    settings: UserSettingsProfileMenuEntry;
+    settings?: UserSettingsProfileMenuEntry;
     itemClick: (item: ProfileItem) => void;
 }
 export interface UserSettingsProfileMenuEntry {
@@ -93,7 +93,21 @@ export interface UserSettingsDialogSettings {
     dialogHeader?: string;
     saveBtn?: string;
     dismissBtn?: string;
-    renderMicroFrontendContainer?: (viewUrl: string, groupKey: string) => Promise<any>;
+    /**
+     * Render the micro-frontend container for a user-settings group.
+     *
+     * The head calls this **when a group becomes active** (selected/visible) and
+     * mounts the returned element into the group's content area. Core owns the
+     * per-group cache: a repeated call for the same `groupKey` returns the already
+     * created container instead of building a new one, so the micro-frontend's
+     * init handshake fires once per group on activation (not at dialog-open),
+     * matching legacy Luigi core — and the head needs no cache of its own.
+     *
+     * @param groupConfig the group's configuration (viewUrl, context, webcomponent, …)
+     * @param groupKey the group's key
+     * @returns the `<luigi-container>` element to mount into the group's content area
+     */
+    renderMicroFrontendContainer?: (groupConfig: Record<string, any>, groupKey: string) => Promise<any>;
     onCloseCallback?: (storedUserSettings: any) => void;
 }
 export interface UserInfo {

package/utilities/helpers/luigi-container-helpers.d.ts

@@ -8,7 +8,7 @@ export type MicrofrontendEntry = {
 export type MicrofrontendInDom = {
     container: HTMLElement;
     active: boolean;
-    type: 'main' | 'modal' | 'drawer';
+    type: 'main' | 'modal' | 'drawer' | 'user-settings';
     id: string;
 };
 export declare const LuigiContainerHelpers: {
@@ -16,5 +16,6 @@ export declare const LuigiContainerHelpers: {
     getMainMicrofrontends(luigi: Luigi): MicrofrontendEntry[];
     getModalMicrofrontends(): MicrofrontendEntry[];
     getDrawerMicrofrontends(): MicrofrontendEntry;
+    getUserSettingsMicrofrontends(): MicrofrontendEntry[];
     getAllLuigiContainerIframe(luigi: Luigi): LuigiContainer[] | undefined;
 };