@gooddata/sdk-ui-pluggable-host 11.52.0-alpha.4 → 11.52.0-alpha.6

package/esm/components/HostUiContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostUiContainer.d.ts","sourceRoot":"","sources":["../../src/components/HostUiContainer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAA0B,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAGH,KAAK,gBAAgB,EAExB,MAAM,2CAA2C,CAAC;AAiBnD,OAAO,wBAAwB,CAAC;AAGhC,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gCAAgC,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,qBAAqB,2CA+S7F"}
+{"version":3,"file":"HostUiContainer.d.ts","sourceRoot":"","sources":["../../src/components/HostUiContainer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAA0B,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAGH,KAAK,gBAAgB,EAExB,MAAM,2CAA2C,CAAC;AAiBnD,OAAO,wBAAwB,CAAC;AAKhC,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gCAAgC,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,qBAAqB,2CAqT7F"}

package/esm/components/HostUiContainer.js

@@ -10,8 +10,8 @@ import { getActiveInternalApplication } from "../loader/routing.js";
 import { HostChat, } from "../ui/HostChat.js";
 import { HostIntlProvider } from "../ui/HostIntlProvider.js";
 import { PluggableApplicationRenderer } from "../ui/PluggableApplicationRenderer.js";
-import { resolveHostUiModule } from "../ui/resolveHostUiModule.js";
 import "./HostUiContainer.scss";
+import { resolveHostUiModule } from "../ui/resolveHostUiModule.js";
 import { runGuardedNavigation } from "./navigationGuard.js";
 /**
  * Mounts the host UI module into a container div, then renders the active
@@ -64,6 +64,10 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
     // app mount handle) and read by HostChat's chat so embedded apps can handle link clicks in-app.
     const appAiLinkClickRef = useRef(undefined);
     const onAppLinkClick = useCallback((link) => appAiLinkClickRef.current?.(link) ?? false, []);
+    // The active app's event handler, populated by PluggableApplicationRenderer (which holds the
+    // app mount handle) and read by HostChat's chat so embedded apps can handle events in-app.
+    const appEventReceiveRef = useRef(undefined);
+    const onAppEventReceive = useCallback((event) => appEventReceiveRef.current?.(event), []);
     const appNavigationRequestRef = useRef(undefined);
     const activeAppRef = useAutoupdateRef(activeInternalApplication);
     const onHeaderChange = useCallback((appId, header) => {
@@ -214,7 +218,7 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
             return;
         }
         if (activeInternalApplication) {
-            appRootRef.current.render(_jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsx(PluggableApplicationRenderer, { app: activeInternalApplication, ctx: ctx, pathname: pathname, aiAssistantOpen: aiAssistantOpen, onOpenAiAssistant: requestOpenAi, onCloseAiAssistant: requestCloseAi, onAiAssistantContext: setAiAssistantContext, aiLinkClickHandlerRef: appAiLinkClickRef, navigationRequestRef: appNavigationRequestRef, onHeaderChange: onHeaderChange, onDocumentTitleChange: onDocumentTitleChange }, activeInternalApplication.id) }));
+            appRootRef.current.render(_jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsx(PluggableApplicationRenderer, { app: activeInternalApplication, ctx: ctx, pathname: pathname, aiAssistantOpen: aiAssistantOpen, onOpenAiAssistant: requestOpenAi, onCloseAiAssistant: requestCloseAi, onAiAssistantContext: setAiAssistantContext, aiLinkClickHandlerRef: appAiLinkClickRef, navigationRequestRef: appNavigationRequestRef, aiEventReceiveRef: appEventReceiveRef, onHeaderChange: onHeaderChange, onDocumentTitleChange: onDocumentTitleChange }, activeInternalApplication.id) }));
         }
         else {
             appRootRef.current.render(null);
@@ -232,5 +236,5 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
         setAiAssistantContext,
     ]);
     return (_jsxs(_Fragment, { children: [
-            _jsx("div", { ref: containerRef, className: "gd-host-ui-container" }), hostReady && !ctx.isExportMode ? (_jsx(HostChat, { ctx: ctx, resolvedApplications: apps, pathname: pathname, activeAppId: activeInternalApplication?.id, visibility: aiVisibility, context: aiContext, onOpenChange: setAiAssistantOpen, onChatStateChange: onChatStateChange, onAppLinkClick: onAppLinkClick })) : null] }));
+            _jsx("div", { ref: containerRef, className: "gd-host-ui-container" }), hostReady && !ctx.isExportMode ? (_jsx(HostChat, { ctx: ctx, resolvedApplications: apps, pathname: pathname, activeAppId: activeInternalApplication?.id, visibility: aiVisibility, context: aiContext, onOpenChange: setAiAssistantOpen, onChatStateChange: onChatStateChange, onAppLinkClick: onAppLinkClick, onAppEventReceive: onAppEventReceive })) : null] }));
 }

package/esm/loader/federationRuntimePlugin.d.ts

@@ -0,0 +1,49 @@
+import { type ModuleFederationRuntimePlugin } from "@module-federation/runtime";
+/**
+ * Timeout applied to every `<link rel="preload">` Module Federation creates.
+ *
+ * MF's DOM helper hardcodes 20s (`createLink` in `@module-federation/sdk`). On a throttled
+ * connection a legitimate asset routinely needs longer, and hitting the timeout is doubly
+ * harmful: the resource is reported as a failure (surfacing as
+ * `preloadRemote failed to load N resource(s)`) *and* the `<link>` is removed from the
+ * document, which cancels the in-flight download. 60s is long enough for a slow but
+ * progressing fetch to land and warm the cache, and short enough that the promise does not
+ * stay pending indefinitely for a user who has long since navigated away.
+ */
+export declare const PRELOAD_LINK_TIMEOUT_MS = 60000;
+/**
+ * Key of the global map in which Module Federation caches remote-entry load promises,
+ * and the separator it composes the map keys with (`SEPARATOR` in `@module-federation/sdk`).
+ *
+ * The map sits on the global root, **not** under `globalThis.__FEDERATION__` where the
+ * instance/share/manifest registries live: `runtime-core`'s `global.js` does
+ * `definePropertyGlobalVal(CurrentGlobal, "__GLOBAL_LOADING_REMOTE_ENTRY__", {})` before it
+ * builds `__FEDERATION__`, and `CurrentGlobal` is `globalThis`. That asymmetry is easy to
+ * "correct" into a silent no-op, so `federationRuntimeGlobals.test.ts` pins it against the
+ * real runtime.
+ *
+ * Exported for that test.
+ */
+export declare const GLOBAL_LOADING_REMOTE_ENTRY = "__GLOBAL_LOADING_REMOTE_ENTRY__";
+/**
+ * Drops a remote entry's cached load promise so the next attempt starts from scratch.
+ *
+ * MF stores the promise returned by `getRemoteEntry` in a process-global map and — as of
+ * `@module-federation/runtime` 2.6.0 — only ever deletes it from `removeRemote`, never when
+ * the promise rejects. A single failed entry load, including one kicked off by a background
+ * hover preload the user never asked for, would therefore be replayed to every later caller
+ * and make that application unopenable for the lifetime of the page.
+ *
+ * Exported for tests.
+ */
+export declare function evictRemoteEntryLoadCache(remoteInfo: {
+    name: string;
+    entry: string;
+}): void;
+/**
+ * Host-side Module Federation runtime plugin. Registered on the federation instance created
+ * by the remote loader; both hooks work around behaviour of the MF runtime we cannot
+ * configure any other way.
+ */
+export declare function createHostFederationPlugin(): ModuleFederationRuntimePlugin;
+//# sourceMappingURL=federationRuntimePlugin.d.ts.map

package/esm/loader/federationRuntimePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federationRuntimePlugin.d.ts","sourceRoot":"","sources":["../../src/loader/federationRuntimePlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,oCAAoC,CAAC;AAK7E;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,6BAA6B,CAgB1E"}

package/esm/loader/federationRuntimePlugin.js

@@ -0,0 +1,66 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Timeout applied to every `<link rel="preload">` Module Federation creates.
+ *
+ * MF's DOM helper hardcodes 20s (`createLink` in `@module-federation/sdk`). On a throttled
+ * connection a legitimate asset routinely needs longer, and hitting the timeout is doubly
+ * harmful: the resource is reported as a failure (surfacing as
+ * `preloadRemote failed to load N resource(s)`) *and* the `<link>` is removed from the
+ * document, which cancels the in-flight download. 60s is long enough for a slow but
+ * progressing fetch to land and warm the cache, and short enough that the promise does not
+ * stay pending indefinitely for a user who has long since navigated away.
+ */
+export const PRELOAD_LINK_TIMEOUT_MS = 60_000;
+/**
+ * Key of the global map in which Module Federation caches remote-entry load promises,
+ * and the separator it composes the map keys with (`SEPARATOR` in `@module-federation/sdk`).
+ *
+ * The map sits on the global root, **not** under `globalThis.__FEDERATION__` where the
+ * instance/share/manifest registries live: `runtime-core`'s `global.js` does
+ * `definePropertyGlobalVal(CurrentGlobal, "__GLOBAL_LOADING_REMOTE_ENTRY__", {})` before it
+ * builds `__FEDERATION__`, and `CurrentGlobal` is `globalThis`. That asymmetry is easy to
+ * "correct" into a silent no-op, so `federationRuntimeGlobals.test.ts` pins it against the
+ * real runtime.
+ *
+ * Exported for that test.
+ */
+export const GLOBAL_LOADING_REMOTE_ENTRY = "__GLOBAL_LOADING_REMOTE_ENTRY__";
+const REMOTE_ENTRY_KEY_SEPARATOR = ":";
+/**
+ * Drops a remote entry's cached load promise so the next attempt starts from scratch.
+ *
+ * MF stores the promise returned by `getRemoteEntry` in a process-global map and — as of
+ * `@module-federation/runtime` 2.6.0 — only ever deletes it from `removeRemote`, never when
+ * the promise rejects. A single failed entry load, including one kicked off by a background
+ * hover preload the user never asked for, would therefore be replayed to every later caller
+ * and make that application unopenable for the lifetime of the page.
+ *
+ * Exported for tests.
+ */
+export function evictRemoteEntryLoadCache(remoteInfo) {
+    const cache = globalThis[GLOBAL_LOADING_REMOTE_ENTRY];
+    if (!cache) {
+        return;
+    }
+    delete cache[`${remoteInfo.name}${REMOTE_ENTRY_KEY_SEPARATOR}${remoteInfo.entry}`];
+}
+/**
+ * Host-side Module Federation runtime plugin. Registered on the federation instance created
+ * by the remote loader; both hooks work around behaviour of the MF runtime we cannot
+ * configure any other way.
+ */
+export function createHostFederationPlugin() {
+    return {
+        name: "gdc-host-remote-loader",
+        // Raise the hardcoded 20s preload-link timeout. Returning an object without `link`
+        // leaves MF's own element (and its attributes) in place — only the timeout changes.
+        createLink: () => ({ timeout: PRELOAD_LINK_TIMEOUT_MS }),
+        // Fires on both the success and the failure path of a remote-entry load; only the
+        // failure path needs the cache evicting.
+        afterLoadEntry: async ({ remoteInfo, error }) => {
+            if (error) {
+                evictRemoteEntryLoadCache(remoteInfo);
+            }
+        },
+    };
+}

package/esm/loader/pluggableApplicationsLoader.d.ts

@@ -9,6 +9,19 @@ import { type IAppLifecycleCallbacks } from "../types/lifecycle.js";
  */
 export declare function registerAppLifecycleCallbacks(callbacks: IAppLifecycleCallbacks): void;
 export declare function getAppLifecycleCallbacks(): IAppLifecycleCallbacks | undefined;
+/**
+ * Whether speculative preloading should be skipped altogether.
+ *
+ * Preloading trades bandwidth for latency, which is a bad trade when bandwidth is the scarce
+ * resource: on a very slow link the preload competes with the requests the page the user is
+ * actually looking at still needs. An explicit Save-Data opt-out is respected for the same
+ * reason.
+ *
+ * `navigator.connection` is not implemented everywhere; absent it we keep preloading.
+ *
+ * Exported for tests.
+ */
+export declare function shouldSkipPreload(): boolean;
 export declare function preloadPluggableApplication(app: PluggableApplicationRegistryItem): void;
 export declare function loadPluggableApplication(app: PluggableApplicationRegistryItem): Promise<IPluggableApp>;
 //# sourceMappingURL=pluggableApplicationsLoader.d.ts.map

package/esm/loader/pluggableApplicationsLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pluggableApplicationsLoader.d.ts","sourceRoot":"","sources":["../../src/loader/pluggableApplicationsLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,gCAAgC,EAIxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAG/E,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAOpE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAErF;AAED,wBAAgB,wBAAwB,IAAI,sBAAsB,GAAG,SAAS,CAE7E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gCAAgC,GAAG,IAAI,CAwBvF;AAED,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,gCAAgC,GACtC,OAAO,CAAC,aAAa,CAAC,CAgBxB"}
+{"version":3,"file":"pluggableApplicationsLoader.d.ts","sourceRoot":"","sources":["../../src/loader/pluggableApplicationsLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,gCAAgC,EAIxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAG/E,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAOpE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAErF;AAED,wBAAgB,wBAAwB,IAAI,sBAAsB,GAAG,SAAS,CAE7E;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAgB3C;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gCAAgC,GAAG,IAAI,CA2BvF;AAED,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,gCAAgC,GACtC,OAAO,CAAC,aAAa,CAAC,CAgBxB"}

package/esm/loader/pluggableApplicationsLoader.js

@@ -16,7 +16,35 @@ export function registerAppLifecycleCallbacks(callbacks) {
 export function getAppLifecycleCallbacks() {
     return registeredLifecycle;
 }
+const PRELOAD_HOSTILE_EFFECTIVE_TYPES = ["slow-2g", "2g"];
+/**
+ * Whether speculative preloading should be skipped altogether.
+ *
+ * Preloading trades bandwidth for latency, which is a bad trade when bandwidth is the scarce
+ * resource: on a very slow link the preload competes with the requests the page the user is
+ * actually looking at still needs. An explicit Save-Data opt-out is respected for the same
+ * reason.
+ *
+ * `navigator.connection` is not implemented everywhere; absent it we keep preloading.
+ *
+ * Exported for tests.
+ */
+export function shouldSkipPreload() {
+    if (typeof navigator === "undefined") {
+        return true;
+    }
+    const connection = navigator.connection;
+    if (!connection) {
+        return false;
+    }
+    return (connection.saveData === true ||
+        (connection.effectiveType !== undefined &&
+            PRELOAD_HOSTILE_EFFECTIVE_TYPES.includes(connection.effectiveType)));
+}
 export function preloadPluggableApplication(app) {
+    if (shouldSkipPreload()) {
+        return;
+    }
     if (isLocalPluggableApplicationRegistryItem(app)) {
         registeredLifecycle?.onPreloadStarted?.(app.id);
         const start = now();

package/esm/loader/remoteLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remoteLoader.d.ts","sourceRoot":"","sources":["../../src/loader/remoteLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,2CAA2C,CAAC;AA4GnG,wBAAgB,8BAA8B,CAC1C,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAiBxB;AA0BD,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAsB,iCAAiC,CACnD,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"remoteLoader.d.ts","sourceRoot":"","sources":["../../src/loader/remoteLoader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAiHnG,wBAAgB,8BAA8B,CAC1C,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAiBxB;AA0BD,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAsB,iCAAiC,CACnD,MAAM,EAAE,iCAAiC,GAC1C,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/esm/loader/remoteLoader.js

@@ -1,12 +1,17 @@
 // (C) 2026 GoodData Corporation
 import { createInstance } from "@module-federation/runtime";
+import { createHostFederationPlugin } from "./federationRuntimePlugin.js";
 import { isAllowedRemoteHostname } from "./remoteUrlSecurity.js";
 const remoteAppPromises = new Map();
 const registeredRemoteScopeUrls = new Map();
 let federation;
 function getFederation() {
     if (!federation) {
-        federation = createInstance({ name: "gdc_host", remotes: [] });
+        federation = createInstance({
+            name: "gdc_host",
+            remotes: [],
+            plugins: [createHostFederationPlugin()],
+        });
     }
     return federation;
 }
@@ -98,18 +103,27 @@ export async function preloadRemotePluggableApplication(remote) {
     // the page. Registration and preload run inside the try so a synchronous registration
     // failure is caught too; on any failure reject after logging, so the caller skips
     // onPreloadCompleted (matching the local and load-remote paths).
+    //
+    // "sync" — not "all" — deliberately: "all" additionally pulls every async chunk reachable
+    // from the expose, which for these applications is hundreds of files. Downloading that
+    // whole graph on hover saturated slow connections (competing with the requests the current
+    // page still needs), and the browser then warned "preloaded but not used" for each chunk
+    // the user never reached. The sync assets are what an actual mount needs first.
     try {
         registerRemote(remote);
         await getFederation().preloadRemote([
             {
                 nameOrAlias: remote.scope,
                 exposes: [normalizeModuleName(remote.module)],
-                resourceCategory: "all",
+                resourceCategory: "sync",
             },
         ]);
     }
     catch (error) {
-        console.error(`[host-runtime/remote-loader] Failed to preload remote "${remote.scope}/${remote.module}".`, error);
+        // warn, not error: preloading is an optimisation. MF counts an asset that has not
+        // finished within the link timeout as a failure, so a slow connection alone produces
+        // this — nothing is broken, the assets are simply fetched again when the app is opened.
+        console.warn(`[host-runtime/remote-loader] Could not preload remote "${remote.scope}/${remote.module}". This is a non-fatal warm-up failure; the application still loads on demand.`, error);
         throw error;
     }
 }

package/esm/ui/GenAIChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GenAIChat.d.ts","sourceRoot":"","sources":["../../src/ui/GenAIChat.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"GenAIChat.d.ts","sourceRoot":"","sources":["../../src/ui/GenAIChat.tsx"],"names":[],"mappings":"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"}

package/esm/ui/GenAIChat.js

@@ -26,15 +26,20 @@ export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, a
     // type (only visualizations did anything). Non-embedded mode uses the connected wrapper's default
     // open/navigate handler instead.
     const onLinkClick = useCallback((link) => {
-        onAppLinkClick?.({
-            type: link.type,
-            id: link.id,
-            itemUrl: link.itemUrl,
-            newTab: link.newTab,
-        });
+        if (!embedded) {
+            const currentUrl = window.location.pathname + window.location.hash;
+            const areUrlsEqual = currentUrl === link.itemUrl;
+            if (link.newTab) {
+                window.open(link.itemUrl, "_blank");
+            }
+            else if (!areUrlsEqual) {
+                window.location.assign(link.itemUrl);
+            }
+        }
+        onAppLinkClick?.(link);
         link.preventDefault();
-        return undefined;
-    }, [onAppLinkClick]);
+        return link.itemUrl;
+    }, [onAppLinkClick, embedded]);
     const handleEvent = useCallback((event) => {
         switch (event.name) {
             case "opened":
@@ -79,5 +84,5 @@ export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, a
                 break;
         }
     }, [addError, addSuccess, intl, onEvent]);
-    return (_jsx(GenAIChatDialogConnected, { backend: backend, workspace: workspaceId, locale: intl.locale, isOpen: open, onOpen: onOpen, onClose: onClose, askedQuestion: askedQuestion, askSeq: askSeq, userContext: userContext, appendToChat: appendToChat, agentId: agentId, replaceUserContext: replaceUserContext, ambientUserContext: ambientUserContext, includeTags: includeTags, excludeTags: excludeTags, canManage: canManageProject, canAnalyze: canAnalyzeProject, canFullControl: canFullControl, settings: settings, dialogPosition: dialogPosition, allowNativeLinks: embedded ? false : undefined, className: embedded ? EMBEDDED_CHAT_CLASS : undefined, onLinkClick: embedded ? onLinkClick : undefined, onEvent: handleEvent, returnFocusTo: embedded ? EMBEDDED_AI_TRIGGER_ID : HEADER_CHAT_BUTTON_ID }));
+    return (_jsx(GenAIChatDialogConnected, { backend: backend, workspace: workspaceId, locale: intl.locale, isOpen: open, onOpen: onOpen, onClose: onClose, askedQuestion: askedQuestion, askSeq: askSeq, userContext: userContext, appendToChat: appendToChat, agentId: agentId, replaceUserContext: replaceUserContext, ambientUserContext: ambientUserContext, includeTags: includeTags, excludeTags: excludeTags, canManage: canManageProject, canAnalyze: canAnalyzeProject, canFullControl: canFullControl, settings: settings, dialogPosition: dialogPosition, className: embedded ? EMBEDDED_CHAT_CLASS : undefined, allowNativeLinks: false, onLinkClick: onLinkClick, onEvent: handleEvent, returnFocusTo: embedded ? EMBEDDED_AI_TRIGGER_ID : HEADER_CHAT_BUTTON_ID }));
 }

package/esm/ui/HostChat.d.ts

@@ -1,5 +1,6 @@
 import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
 import { type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+import { GenAIChatEvent } from "./GenAIChat.js";
 import "@gooddata/sdk-ui-gen-ai/styles/css/main.css";
 /**
  * AI-assistant open/close/toggle request. `seq` changes on every request so an identical repeat
@@ -58,6 +59,10 @@ export interface IHostChatProps {
      * visualization as an in-place overlay). Returns true if the app handled it.
      */
     onAppLinkClick?: (link: IHostChatLink) => boolean;
+    /**
+     * Delegates a chat event receive to the active application.
+     */
+    onAppEventReceive?: (event: GenAIChatEvent) => void;
 }
 /**
  * Owns and renders the host's single GenAI chat, decoupled from the host UI module.
@@ -68,5 +73,5 @@ export interface IHostChatProps {
  * (embedded/export). The header chat button and app-side controls drive it through the `visibility`
  * and `context` props; it reports its open-state and button state back via callbacks.
  */
-export declare function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility, context, onOpenChange, onChatStateChange, onAppLinkClick }: IHostChatProps): import("react/jsx-runtime").JSX.Element;
+export declare function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility, context, onOpenChange, onChatStateChange, onAppLinkClick, onAppEventReceive }: IHostChatProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=HostChat.d.ts.map

package/esm/ui/HostChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostChat.d.ts","sourceRoot":"","sources":["../../src/ui/HostChat.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAUlF,OAAO,6CAA6C,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,oFAAoF;IACpF,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChF;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACrB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,UAAiB,EACjB,OAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACjB,EAAE,cAAc,2CA0FhB"}
+{"version":3,"file":"HostChat.d.ts","sourceRoot":"","sources":["../../src/ui/HostChat.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAOlF,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,6CAA6C,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,oFAAoF;IACpF,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChF;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;IAClD;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACrB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,UAAiB,EACjB,OAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACpB,EAAE,cAAc,2CA2FhB"}

package/esm/ui/HostChat.js

@@ -18,7 +18,7 @@ import "@gooddata/sdk-ui-gen-ai/styles/css/main.css";
  * (embedded/export). The header chat button and app-side controls drive it through the `visibility`
  * and `context` props; it reports its open-state and button state back via callbacks.
  */
-export function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility = null, context = null, onOpenChange, onChatStateChange, onAppLinkClick, }) {
+export function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility = null, context = null, onOpenChange, onChatStateChange, onAppLinkClick, onAppEventReceive, }) {
     const features = useHostChromeWorkspaceFeatures(resolvedApplications, ctx, pathname);
     const shellTelemetry = useMemo(() => getAppLifecycleCallbacks()?.createTelemetryCallbacks?.("host-ui"), []);
     const chat = useHostChromeChat({
@@ -28,6 +28,7 @@ export function HostChat({ ctx, resolvedApplications, pathname, activeAppId, vis
         dialogPosition: context?.dialogPosition,
         embedded: context?.embedded,
         onAppLinkClick,
+        onAppEventReceive,
     });
     const { askAiAssistant: chatAskAiAssistant, openAiAssistant: chatOpenAiAssistant, open: chatOpen, close: chatClose, toggle: chatToggle, setTags: chatSetTags, setAmbientUserContext: chatSetAmbientUserContext, isOpen: chatIsOpen, showChatItem, } = chat;
     // Report the chat open-state outward so the runtime can forward it to the active pluggable

package/esm/ui/HostChrome.d.ts

@@ -32,5 +32,5 @@ export interface IHostChromeProps {
     appPageTitle?: string;
     children?: ReactNode;
 }
-export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, showChatItem, onChatToggle, onAskAiAssistant, appPageTitle, children }: IHostChromeProps): import("react/jsx-runtime").JSX.Element;
+export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, showChatItem, chatIsOpen, onChatToggle, onAskAiAssistant, appPageTitle, children }: IHostChromeProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=HostChrome.d.ts.map

package/esm/ui/HostChrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostChrome.d.ts","sourceRoot":"","sources":["../../src/ui/HostChrome.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AAElG,OAAO,EAEH,KAAK,iBAAiB,EAEtB,KAAK,gCAAgC,EACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACxB,MAAM,2CAA2C,CAAC;AA+BnD,OAAO,mBAAmB,CAAC;AAK3B,OAAO,0CAA0C,CAAC;AAClD,OAAO,6CAA6C,CAAC;AACrD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,0DAA0D,CAAC;AAelE,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,EACvB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EAAE,UAAU,EACrB,aAAa,EACb,YAAmB,EACnB,YAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACX,EAAE,gBAAgB,2CA0OlB"}
+{"version":3,"file":"HostChrome.d.ts","sourceRoot":"","sources":["../../src/ui/HostChrome.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AAElG,OAAO,EACH,KAAK,iBAAiB,EAEtB,KAAK,gCAAgC,EACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACxB,MAAM,2CAA2C,CAAC;AA6BnD,OAAO,mBAAmB,CAAC;AAK3B,OAAO,0CAA0C,CAAC;AAClD,OAAO,6CAA6C,CAAC;AACrD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,0DAA0D,CAAC;AAelE,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,EACvB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EAAE,UAAU,EACrB,aAAa,EACb,YAAmB,EACnB,YAAoB,EACpB,UAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACX,EAAE,gBAAgB,2CA0NlB"}

package/esm/ui/HostChrome.js

@@ -1,20 +1,20 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
 import { useCallback, useMemo } from "react";
-import { isExternalPluggableApplicationRegistryItem, } from "@gooddata/sdk-model";
 import { BackendProvider, resolveLocale } from "@gooddata/sdk-ui";
 import { AppHeaderNotifications } from "@gooddata/sdk-ui-application-header";
 import { AppHeader, DocumentHeader, ToastsCenterContextProvider, generateHeaderAccountMenuItems, generateHeaderStaticHelpMenuItems, } from "@gooddata/sdk-ui-kit";
 import { defaultHeaderTheme } from "@gooddata/sdk-ui-theme-provider";
 import defaultLogoUrl from "../assets/logo-white.svg";
-import { getAppLifecycleCallbacks, preloadPluggableApplication, } from "../loader/pluggableApplicationsLoader.js";
-import { getActiveInternalApplication, getApplicationHref } from "../loader/routing.js";
+import { getAppLifecycleCallbacks } from "../loader/pluggableApplicationsLoader.js";
+import { getActiveInternalApplication } from "../loader/routing.js";
 import { getBackend } from "../platformContext/backend.js";
 import { buildAppMenu, getLocalizedTitle } from "./appMenuItems.js";
 import { getUserDisplayName, isPlainLeftClick, swapWorkspaceInPath } from "./chromeHelpers.js";
 import { b, e } from "./hostChromeBem.js";
 import { HostIntlProvider } from "./HostIntlProvider.js";
 import { HostNotificationDispatcher } from "./HostNotificationDispatcher.js";
+import { useAppPreloadOnHover } from "./useAppPreloadOnHover.js";
 import { useHostChromePricing } from "./useHostChromePricing.js";
 import { useHostChromeSearch } from "./useHostChromeSearch.js";
 import { useHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
@@ -37,7 +37,7 @@ const initialFaviconUrl = (typeof document !== "undefined" && document.querySele
     "/favicon.ico";
 // Switches the host scope to organization; the first organization app is then chosen by redirect logic.
 const LOGO_HREF = "/organization";
-export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification = null, showChatItem = false, onChatToggle, onAskAiAssistant, appPageTitle, children, }) {
+export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification = null, showChatItem = false, chatIsOpen = false, onChatToggle, onAskAiAssistant, appPageTitle, children, }) {
     const locale = resolveLocale(ctx.preferredLocale);
     const userName = getUserDisplayName(ctx.user);
     const features = useHostChromeWorkspaceFeatures(resolvedApplications, ctx, pathname);
@@ -83,25 +83,7 @@ export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, on
             }
         }
     }, [onNavigate]);
-    const handleHeaderMouseOver = useCallback((e) => {
-        const anchor = e.target.closest("a[href]");
-        if (!anchor) {
-            return;
-        }
-        const href = anchor.getAttribute("href");
-        if (!href) {
-            return;
-        }
-        for (const app of resolvedApplications) {
-            if (!isExternalPluggableApplicationRegistryItem(app)) {
-                const appHref = getApplicationHref(app, ctx, pathname);
-                if (appHref === href) {
-                    preloadPluggableApplication(app);
-                    return;
-                }
-            }
-        }
-    }, [resolvedApplications, ctx, pathname]);
+    const appPreloadOnHover = useAppPreloadOnHover(resolvedApplications, ctx, pathname);
     // Without this the anchor would do a full page load instead of a client-side navigation.
     const handleLogoClick = useCallback((e) => {
         if (!isPlainLeftClick(e)) {
@@ -153,6 +135,6 @@ export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, on
     const activeColor = ctx.theme?.header?.activeColor ?? defaultHeaderTheme.activeColor;
     const hideChrome = ctx.embeddingMode === "iframe" || ctx.isExportMode === true;
     return (_jsx(HostIntlProvider, { locale: locale, additionalMessages: appMessages, children: _jsx(BackendProvider, { backend: getBackend(), children: _jsx(ToastsCenterContextProvider, { children: _jsxs("div", { className: b(), children: [
-                        _jsx(DocumentHeader, { pageTitle: documentPageTitle, brandTitle: documentBrandTitle, faviconUrl: faviconUrl, appleTouchIconUrl: ctx.whiteLabeling?.appleTouchIconUrl }), hideChrome ? null : (_jsx("div", { className: e("header"), onMouseOver: handleHeaderMouseOver, children: _jsx(AppHeader, { logoUrl: ctx.whiteLabeling?.logoUrl || defaultLogoUrl, logoHref: LOGO_HREF, onLogoClick: handleLogoClick, logoTitle: logoTitle, headerColor: headerColor, headerTextColor: headerTextColor, activeColor: activeColor, userName: userName, organizationName: ctx.organization?.title, isAccessibilityCompliant: true, workspacePicker: workspacePicker, menuItemsGroups: menuItemsGroups, helpMenuItems: helpMenuItems, accountMenuItems: accountMenuItems, onMenuItemClick: handleMenuItemClick, showUpsellButton: pricing.isTrial, onUpsellButtonClick: pricing.onUpsellButtonClick, expiredDate: pricing.isTrial ? pricing.expiredDate : undefined, search: search.element, showChatItem: showChatItem, onChatItemClick: onChatToggle, notificationsPanel: ({ isMobile, closeNotificationsOverlay }) => (_jsx(AppHeaderNotifications, { locale: locale, isMobile: isMobile, closeNotificationsOverlay: closeNotificationsOverlay, useAsOfDateParam: true, enableExportToDocumentStorage: ctx.userSettings.enableExportToDocumentStorage ?? false })) }) })), _jsx("main", { className: e("content"), children: children }), pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
+                        _jsx(DocumentHeader, { pageTitle: documentPageTitle, brandTitle: documentBrandTitle, faviconUrl: faviconUrl, appleTouchIconUrl: ctx.whiteLabeling?.appleTouchIconUrl }), hideChrome ? null : (_jsx("div", { className: e("header"), onMouseOver: appPreloadOnHover.onMouseOver, onMouseLeave: appPreloadOnHover.onMouseLeave, children: _jsx(AppHeader, { logoUrl: ctx.whiteLabeling?.logoUrl || defaultLogoUrl, logoHref: LOGO_HREF, onLogoClick: handleLogoClick, logoTitle: logoTitle, headerColor: headerColor, headerTextColor: headerTextColor, activeColor: activeColor, userName: userName, organizationName: ctx.organization?.title, isAccessibilityCompliant: true, workspacePicker: workspacePicker, menuItemsGroups: menuItemsGroups, helpMenuItems: helpMenuItems, accountMenuItems: accountMenuItems, onMenuItemClick: handleMenuItemClick, showUpsellButton: pricing.isTrial, onUpsellButtonClick: pricing.onUpsellButtonClick, expiredDate: pricing.isTrial ? pricing.expiredDate : undefined, search: search.element, showChatItem: showChatItem, isChatOpen: chatIsOpen, onChatItemClick: onChatToggle, notificationsPanel: ({ isMobile, closeNotificationsOverlay }) => (_jsx(AppHeaderNotifications, { locale: locale, isMobile: isMobile, closeNotificationsOverlay: closeNotificationsOverlay, useAsOfDateParam: true, enableExportToDocumentStorage: ctx.userSettings.enableExportToDocumentStorage ?? false })) }) })), _jsx("main", { className: e("content"), children: children }), pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
                     ] }) }) }) }));
 }

package/esm/ui/PluggableApplicationRenderer.d.ts

@@ -2,6 +2,7 @@ import { type RefObject } from "react";
 import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
 import { type IAppHeaderOptions, type IHostNavigationRequest, type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
 import "./PluggableApplicationRenderer.scss";
+import { GenAIChatEvent } from "./GenAIChat.js";
 export interface IPluggableApplicationRendererProps {
     app: PluggableApplicationRegistryItem;
     ctx: IPlatformContext;
@@ -30,6 +31,11 @@ export interface IPluggableApplicationRendererProps {
         itemUrl?: string;
         newTab?: boolean;
     }) => boolean) | undefined>;
+    /**
+     * Ref the renderer populates with a handler that delegates a host-chat event to the active
+     * app's mount handle (`onAiAssistantEventReceive`), so an embedded app can handle it in-app.
+     */
+    aiEventReceiveRef?: RefObject<((event: GenAIChatEvent) => void) | undefined>;
     /**
      * Ref the renderer populates with a handler that asks the active app's mount handle
      * (`onHostNavigationRequested`) whether the host may navigate away. Must be referentially
@@ -39,5 +45,5 @@ export interface IPluggableApplicationRendererProps {
     onHeaderChange?: (appId: string, header: IAppHeaderOptions) => void;
     onDocumentTitleChange?: (appId: string, pageTitle: string | undefined) => void;
 }
-export declare function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, navigationRequestRef, onHeaderChange, onDocumentTitleChange }: IPluggableApplicationRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, aiEventReceiveRef, navigationRequestRef, onHeaderChange, onDocumentTitleChange }: IPluggableApplicationRendererProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=PluggableApplicationRenderer.d.ts.map

package/esm/ui/PluggableApplicationRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluggableApplicationRenderer.d.ts","sourceRoot":"","sources":["../../src/ui/PluggableApplicationRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAqD,MAAM,OAAO,CAAC;AAI1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EASxB,MAAM,2CAA2C,CAAC;AAcnD,OAAO,qCAAqC,CAAC;AAkB7C,MAAM,WAAW,kCAAkC;IAC/C,GAAG,EAAE,gCAAgC,CAAC;IACtC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,oHAAoH;IACpH,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,iBAAiB,CAAC;KACnC,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAC7B,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,SAAS,CACtG,CAAC;IACF;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7F,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAClF;AAED,wBAAgB,4BAA4B,CAAC,EACzC,GAAG,EACH,GAAG,EACH,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACxB,EAAE,kCAAkC,2CA8RpC"}
+{"version":3,"file":"PluggableApplicationRenderer.d.ts","sourceRoot":"","sources":["../../src/ui/PluggableApplicationRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAqD,MAAM,OAAO,CAAC;AAI1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EASxB,MAAM,2CAA2C,CAAC;AAcnD,OAAO,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkBhD,MAAM,WAAW,kCAAkC;IAC/C,GAAG,EAAE,gCAAgC,CAAC;IACtC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,oHAAoH;IACpH,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,iBAAiB,CAAC;KACnC,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAC7B,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,SAAS,CACtG,CAAC;IACF;;;OAGG;IACH,iBAAiB,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7E;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7F,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAClF;AAED,wBAAgB,4BAA4B,CAAC,EACzC,GAAG,EACH,GAAG,EACH,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACxB,EAAE,kCAAkC,2CA4SpC"}

package/esm/ui/PluggableApplicationRenderer.js

@@ -20,7 +20,7 @@ const SECURITY_FAILURE_MESSAGES = {
     "build-expired": defineMessage({ id: "gs.host.error.appBuildExpired" }),
     "metadata-missing": defineMessage({ id: "gs.host.error.appSecurityMetadataMissing" }),
 };
-export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, navigationRequestRef, onHeaderChange, onDocumentTitleChange, }) {
+export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, aiEventReceiveRef, navigationRequestRef, onHeaderChange, onDocumentTitleChange, }) {
     const intl = useIntl();
     const intlRef = useAutoupdateRef(intl);
     const ctxRef = useAutoupdateRef(ctx);
@@ -227,6 +227,19 @@ export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOp
             ref.current = undefined;
         };
     }, [aiLinkClickHandlerRef]);
+    // Expose a host-chat event delegate that defers to the active app's mount handle, so an
+    // embedded app can handle events in-app. Read through the ref at call time so it
+    // always targets the currently mounted app.
+    useEffect(() => {
+        const ref = aiEventReceiveRef;
+        if (!ref) {
+            return;
+        }
+        ref.current = (event) => mountHandleRef.current?.onAiAssistantEventReceive?.(event);
+        return () => {
+            ref.current = undefined;
+        };
+    }, [aiEventReceiveRef]);
     return (_jsxs("section", { className: b(), children: [viewState.state === "loading" ? (_jsx("div", { className: e("loading"), children: _jsx(LoadingComponent, { height: 40 }) })) : null, viewState.state === "error" ? (_jsxs("div", { className: e("error"), children: [
                     _jsx("h2", { children: _jsx(FormattedMessage, { id: "gs.host.error.applicationFailedToLoad" }) }), _jsx("p", { children: viewState.message })
                 ] })) : null, _jsx("div", { ref: containerRef, className: e("container", { visible: viewState.state === "ready" }) }), viewState.state === "ready" && viewState.validUntil !== undefined ? (_jsx("div", { className: e("demoBadge"), role: "status", children: _jsx(FormattedMessage, { id: "gs.host.demoApp.validUntil", values: {

package/esm/ui/useAppPreloadOnHover.d.ts

@@ -0,0 +1,29 @@
+import { type MouseEvent } from "react";
+import { type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+/**
+ * How long the pointer has to rest on an application link before its bundle is preloaded.
+ *
+ * The handler is attached to the header wrapper, so a pointer swept across the navigation
+ * passes over every link. Firing immediately would preload every application at once —
+ * hundreds of requests for applications the user is not going to open. Waiting for the
+ * pointer to settle turns "crossed the link" into "aimed at the link".
+ */
+export declare const PRELOAD_HOVER_INTENT_MS = 150;
+/**
+ * @internal
+ */
+export interface IAppPreloadOnHoverHandlers {
+    onMouseOver: (event: MouseEvent<HTMLElement>) => void;
+    onMouseLeave: () => void;
+}
+/**
+ * Preloads an application's bundle when the pointer settles on its header link.
+ *
+ * Each application is scheduled at most once — the preload itself is idempotent, but there is
+ * no point re-arming a timer for a bundle already requested.
+ *
+ * @internal
+ */
+export declare function useAppPreloadOnHover(resolvedApplications: PluggableApplicationRegistryItem[], ctx: IPlatformContext, pathname: string): IAppPreloadOnHoverHandlers;
+//# sourceMappingURL=useAppPreloadOnHover.d.ts.map

package/esm/ui/useAppPreloadOnHover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppPreloadOnHover.d.ts","sourceRoot":"","sources":["../../src/ui/useAppPreloadOnHover.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAkC,MAAM,OAAO,CAAC;AAExE,OAAO,EAEH,KAAK,gCAAgC,EACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAKlF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,oBAAoB,EAAE,gCAAgC,EAAE,EACxD,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACjB,0BAA0B,CAsD5B"}

package/esm/ui/useAppPreloadOnHover.js

@@ -0,0 +1,69 @@
+// (C) 2026 GoodData Corporation
+import { useCallback, useEffect, useRef } from "react";
+import { isExternalPluggableApplicationRegistryItem, } from "@gooddata/sdk-model";
+import { preloadPluggableApplication } from "../loader/pluggableApplicationsLoader.js";
+import { getApplicationHref } from "../loader/routing.js";
+/**
+ * How long the pointer has to rest on an application link before its bundle is preloaded.
+ *
+ * The handler is attached to the header wrapper, so a pointer swept across the navigation
+ * passes over every link. Firing immediately would preload every application at once —
+ * hundreds of requests for applications the user is not going to open. Waiting for the
+ * pointer to settle turns "crossed the link" into "aimed at the link".
+ */
+export const PRELOAD_HOVER_INTENT_MS = 150;
+/**
+ * Preloads an application's bundle when the pointer settles on its header link.
+ *
+ * Each application is scheduled at most once — the preload itself is idempotent, but there is
+ * no point re-arming a timer for a bundle already requested.
+ *
+ * @internal
+ */
+export function useAppPreloadOnHover(resolvedApplications, ctx, pathname) {
+    const timeoutRef = useRef(undefined);
+    const scheduledAppIdsRef = useRef(new Set());
+    const cancelPendingPreload = useCallback(() => {
+        if (timeoutRef.current !== undefined) {
+            window.clearTimeout(timeoutRef.current);
+            timeoutRef.current = undefined;
+        }
+    }, []);
+    // Do not leave a timer behind that would preload into an unmounted chrome.
+    useEffect(() => cancelPendingPreload, [cancelPendingPreload]);
+    const onMouseOver = useCallback((event) => {
+        // Any movement inside the header invalidates a pending preload: the pointer has
+        // left the link it was aimed at, so it never settled there. Cancelling up front
+        // covers every way out of this handler — a non-anchor target such as the workspace
+        // picker, an anchor belonging to no application, and an external application —
+        // whereas the header's own onMouseLeave only fires once the pointer is out of the
+        // header entirely. Re-armed below if the pointer landed on an application link.
+        cancelPendingPreload();
+        const anchor = event.target.closest("a[href]");
+        if (!anchor) {
+            return;
+        }
+        const href = anchor.getAttribute("href");
+        if (!href) {
+            return;
+        }
+        for (const app of resolvedApplications) {
+            if (isExternalPluggableApplicationRegistryItem(app)) {
+                continue;
+            }
+            if (getApplicationHref(app, ctx, pathname) !== href) {
+                continue;
+            }
+            if (scheduledAppIdsRef.current.has(app.id)) {
+                return;
+            }
+            timeoutRef.current = window.setTimeout(() => {
+                timeoutRef.current = undefined;
+                scheduledAppIdsRef.current.add(app.id);
+                preloadPluggableApplication(app);
+            }, PRELOAD_HOVER_INTENT_MS);
+            return;
+        }
+    }, [resolvedApplications, ctx, pathname, cancelPendingPreload]);
+    return { onMouseOver, onMouseLeave: cancelPendingPreload };
+}

package/esm/ui/useHostChromeChat.d.ts

@@ -1,6 +1,7 @@
 import { type ReactNode } from "react";
 import { type IGenAIUserContext } from "@gooddata/sdk-model";
 import { type IPlatformContext, type IPluggableAppTelemetryCallbacks } from "@gooddata/sdk-pluggable-application-model";
+import { type GenAIChatEvent } from "./GenAIChat.js";
 import { type IHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
 export interface IHostChromeChat {
     /** The `<GenAIChat>` element to mount, or `null` when chat is gated off. */
@@ -54,6 +55,8 @@ export interface IUseHostChromeChatArgs {
         itemUrl?: string;
         newTab?: boolean;
     }) => boolean;
+    /** Delegates a chat event receive to the active app. */
+    onAppEventReceive?: (event: GenAIChatEvent) => void;
 }
 /**
  * Owns the GenAI chat state and renders the `<GenAIChat>` element for the host chrome.
@@ -62,5 +65,5 @@ export interface IUseHostChromeChatArgs {
  * points, the runtime availability probe (`useGenAiChatAvailability`) and forwarding chat
  * events to the host telemetry callbacks.
  */
-export declare function useHostChromeChat({ features, ctx, telemetry, dialogPosition, embedded, onAppLinkClick }: IUseHostChromeChatArgs): IHostChromeChat;
+export declare function useHostChromeChat({ features, ctx, telemetry, dialogPosition, embedded, onAppLinkClick, onAppEventReceive }: IUseHostChromeChatArgs): IHostChromeChat;
 //# sourceMappingURL=useHostChromeChat.d.ts.map

package/esm/ui/useHostChromeChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHostChromeChat.d.ts","sourceRoot":"","sources":["../../src/ui/useHostChromeChat.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACvC,MAAM,2CAA2C,CAAC;AAMnD,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA2E;IAC3E,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV;;;OAGG;IACH,eAAe,EAAE,CACb,WAAW,CAAC,EAAE,iBAAiB,EAC/B,kBAAkB,CAAC,EAAE,OAAO,EAC5B,OAAO,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV;;;OAGG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,qBAAqB,EAAE,CAAC,WAAW,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,GAAG,EAAE,gBAAgB,CAAC;IACtB,SAAS,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACvD,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;CAC1G;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,QAAQ,EACR,GAAG,EACH,SAAS,EACT,cAAc,EACd,QAAQ,EACR,cAAc,EACjB,EAAE,sBAAsB,GAAG,eAAe,CAwH1C"}
+{"version":3,"file":"useHostChromeChat.d.ts","sourceRoot":"","sources":["../../src/ui/useHostChromeChat.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACvC,MAAM,2CAA2C,CAAC;AAKnD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA2E;IAC3E,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,YAAY,CAAC,EAAE,OAAO,EACtB,kBAAkB,CAAC,EAAE,OAAO,KAC3B,IAAI,CAAC;IACV;;;OAGG;IACH,eAAe,EAAE,CACb,WAAW,CAAC,EAAE,iBAAiB,EAC/B,kBAAkB,CAAC,EAAE,OAAO,EAC5B,OAAO,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV;;;OAGG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,qBAAqB,EAAE,CAAC,WAAW,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,GAAG,EAAE,gBAAgB,CAAC;IACtB,SAAS,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACvD,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IACvG,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,QAAQ,EACR,GAAG,EACH,SAAS,EACT,cAAc,EACd,QAAQ,EACR,cAAc,EACd,iBAAiB,EACpB,EAAE,sBAAsB,GAAG,eAAe,CAyH1C"}

package/esm/ui/useHostChromeChat.js

@@ -11,7 +11,7 @@ import { GenAIChat } from "./GenAIChat.js";
  * points, the runtime availability probe (`useGenAiChatAvailability`) and forwarding chat
  * events to the host telemetry callbacks.
  */
-export function useHostChromeChat({ features, ctx, telemetry, dialogPosition, embedded, onAppLinkClick, }) {
+export function useHostChromeChat({ features, ctx, telemetry, dialogPosition, embedded, onAppLinkClick, onAppEventReceive, }) {
     const [isChatOpen, setIsChatOpen] = useState(false);
     const [askedQuestion, setAskedQuestion] = useState(null);
     const [appendToChat, setAppendToChat] = useState(false);
@@ -61,7 +61,8 @@ export function useHostChromeChat({ features, ctx, telemetry, dialogPosition, em
     }, []);
     const handleChatEvent = useCallback((event) => {
         telemetry?.trackEvent(event.name, event.payload);
-    }, [telemetry]);
+        onAppEventReceive?.(event);
+    }, [telemetry, onAppEventReceive]);
     const showChatItem = useGenAiChatAvailability(getBackend(), features.workspaceId, features.showChat, features.canManageProject);
     const element = features.showChat && features.workspaceId ? (_jsx(GenAIChat, { workspaceId: features.workspaceId, open: isChatOpen, onOpen: open, onClose: close, askedQuestion: askedQuestion, appendToChat: appendToChat, agentId: agentId, replaceUserContext: replaceUserContext, askSeq: askSeq, userContext: userContext, ambientUserContext: ambientUserContext, includeTags: includeTags, excludeTags: excludeTags, canManageProject: features.canManageProject, canAnalyzeProject: features.canCreateVisualization, canFullControl: features.canFullControl, settings: ctx.workspaceSettings, dialogPosition: dialogPosition, embedded: embedded, onAppLinkClick: onAppLinkClick, onEvent: handleChatEvent })) : null;
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-pluggable-host",
-  "version": "11.52.0-alpha.4",
+  "version": "11.52.0-alpha.6",
   "description": "GoodData SDK runtime for hosting pluggable applications — registry, loader, routing, platform context, default UI chrome",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -29,20 +29,20 @@
   "dependencies": {
     "@module-federation/runtime": "2.6.0",
     "lodash-es": "^4.17.23",
-    "@gooddata/sdk-backend-base": "11.52.0-alpha.4",
-    "@gooddata/sdk-backend-tiger": "11.52.0-alpha.4",
-    "@gooddata/sdk-backend-spi": "11.52.0-alpha.4",
-    "@gooddata/sdk-embedding": "11.52.0-alpha.4",
-    "@gooddata/sdk-model": "11.52.0-alpha.4",
-    "@gooddata/sdk-pluggable-application-model": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-application-header": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-ext": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-kit": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-gen-ai": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-theme-provider": "11.52.0-alpha.4",
-    "@gooddata/sdk-ui-semantic-search": "11.52.0-alpha.4",
-    "@gooddata/util": "11.52.0-alpha.4"
+    "@gooddata/sdk-backend-base": "11.52.0-alpha.6",
+    "@gooddata/sdk-embedding": "11.52.0-alpha.6",
+    "@gooddata/sdk-backend-tiger": "11.52.0-alpha.6",
+    "@gooddata/sdk-backend-spi": "11.52.0-alpha.6",
+    "@gooddata/sdk-model": "11.52.0-alpha.6",
+    "@gooddata/sdk-pluggable-application-model": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-application-header": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-ext": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-gen-ai": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-semantic-search": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-kit": "11.52.0-alpha.6",
+    "@gooddata/sdk-ui-theme-provider": "11.52.0-alpha.6",
+    "@gooddata/util": "11.52.0-alpha.6"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -85,8 +85,8 @@
     "vite": "8.0.16",
     "vitest": "4.1.8",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.52.0-alpha.4",
-    "@gooddata/oxlint-config": "11.52.0-alpha.4"
+    "@gooddata/eslint-config": "11.52.0-alpha.6",
+    "@gooddata/oxlint-config": "11.52.0-alpha.6"
   },
   "peerDependencies": {
     "react": ">=18.3.1",