@gooddata/sdk-ui-pluggable-host 11.40.0-alpha.3

package/esm/ui/resolveHostUiModule.d.ts

@@ -0,0 +1,8 @@
+import { type IPlatformContext, type IHostUiModule } from "@gooddata/sdk-pluggable-application-model";
+/**
+ * Resolves the host UI module to use.
+ *
+ * If the remote pluggable applications registry specifies a `uiModule`, it will be loaded
+ * via module federation. Otherwise, the built-in default host UI is used.
+ */
+export declare function resolveHostUiModule(ctx: IPlatformContext): Promise<IHostUiModule>;

package/esm/ui/resolveHostUiModule.js

@@ -0,0 +1,22 @@
+// (C) 2026 GoodData Corporation
+import { loadRemoteHostUiModule } from "../loader/remoteLoader.js";
+import { getRemoteRegistry } from "../registry/pluggableApplicationsRegistry.js";
+import { defaultHostUiModule } from "./DefaultHostUi.js";
+/**
+ * Resolves the host UI module to use.
+ *
+ * If the remote pluggable applications registry specifies a `uiModule`, it will be loaded
+ * via module federation. Otherwise, the built-in default host UI is used.
+ */
+export async function resolveHostUiModule(ctx) {
+    const remoteRegistry = getRemoteRegistry(ctx);
+    if (remoteRegistry?.uiModule) {
+        try {
+            return await loadRemoteHostUiModule(remoteRegistry.uiModule);
+        }
+        catch (error) {
+            console.error("[host-runtime/resolve-ui] Failed to load remote UI module, falling back to default.", error);
+        }
+    }
+    return defaultHostUiModule;
+}

package/esm/ui/useHostChromeChat.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from "react";
+import { type IPlatformContext, type IPluggableAppTelemetryCallbacks } from "@gooddata/sdk-pluggable-application-model";
+import { type IHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
+export interface IHostChromeChat {
+    /** The `<GenAIChat>` element to mount, or `null` when chat is gated off. */
+    element: ReactNode;
+    /**
+     * Whether the chat entry point should be visible in the header. Reflects both the
+     * feature-flag/permission gate and the runtime LLM availability probe.
+     */
+    showChatItem: boolean;
+    /** Open the chat dialog. */
+    open: () => void;
+    /** Open the chat dialog with a pre-seeded user question. */
+    askAiAssistant: (question: string) => void;
+}
+export interface IUseHostChromeChatArgs {
+    features: IHostChromeWorkspaceFeatures;
+    ctx: IPlatformContext;
+    telemetry: IPluggableAppTelemetryCallbacks | undefined;
+}
+/**
+ * Owns the GenAI chat state and renders the `<GenAIChat>` element for the host chrome.
+ *
+ * Encapsulates open/close state, the seeded-question flow used by the AI-assistant entry
+ * points, the runtime availability probe (`useGenAiChatAvailability`) and forwarding chat
+ * events to the host telemetry callbacks.
+ */
+export declare function useHostChromeChat({ features, ctx, telemetry }: IUseHostChromeChatArgs): IHostChromeChat;

package/esm/ui/useHostChromeChat.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useCallback, useState } from "react";
+import { useGenAiChatAvailability } from "@gooddata/sdk-ui-gen-ai";
+import { getBackend } from "../platformContext/backend.js";
+import { GenAIChat } from "./GenAIChat.js";
+/**
+ * Owns the GenAI chat state and renders the `<GenAIChat>` element for the host chrome.
+ *
+ * Encapsulates open/close state, the seeded-question flow used by the AI-assistant entry
+ * points, the runtime availability probe (`useGenAiChatAvailability`) and forwarding chat
+ * events to the host telemetry callbacks.
+ */
+export function useHostChromeChat({ features, ctx, telemetry }) {
+    const [isChatOpen, setIsChatOpen] = useState(false);
+    const [askedQuestion, setAskedQuestion] = useState(null);
+    const open = useCallback(() => {
+        setIsChatOpen(true);
+    }, []);
+    const close = useCallback(() => {
+        setIsChatOpen(false);
+    }, []);
+    const askAiAssistant = useCallback((question) => {
+        setAskedQuestion(question);
+        setIsChatOpen(true);
+    }, []);
+    const handleChatEvent = useCallback((event) => {
+        telemetry?.trackEvent(event.name, event.payload);
+    }, [telemetry]);
+    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, canManageProject: features.canManageProject, canAnalyzeProject: features.canAccessWorkbench, canFullControl: features.canFullControl, settings: ctx.workspaceSettings, onEvent: handleChatEvent })) : null;
+    return {
+        element,
+        showChatItem,
+        open,
+        askAiAssistant,
+    };
+}

package/esm/ui/useHostChromePricing.d.ts

@@ -0,0 +1,52 @@
+import { type ReactNode } from "react";
+import { type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+/**
+ * Shape returned by a pricing extension hook. Provides the trial-info derived from
+ * entitlements + a dialog element so the host chrome can wire the upsell affordances
+ * on `<AppHeader>` without owning the dialog implementation.
+ *
+ * @alpha
+ */
+export interface IHostChromePricing {
+    /** The pricing dialog React element (or null to skip rendering). */
+    element: ReactNode;
+    /** Whether the current org is on a trial entitlement (drives upsell button visibility). */
+    isTrial: boolean;
+    /** ISO date string for the trial contract expiry, derived from entitlements. */
+    expiredDate: string;
+    /** Open the pricing dialog (wired to the upsell button click). */
+    onUpsellButtonClick: () => void;
+}
+/**
+ * A host pricing extension. The `Use` prefix signals that this MUST be a React hook —
+ * it is invoked from `HostChrome`'s render and therefore must obey the React Rules of
+ * Hooks (stable call order, no conditional hook calls, etc.).
+ *
+ * @alpha
+ */
+export type UseHostPricingExtension = (ctx: IPlatformContext, locale: string) => IHostChromePricing;
+/**
+ * Registers a pricing extension that the default host chrome will consume to render
+ * trial-upgrade affordances. Optional — when no extension is registered, the chrome
+ * shows no upsell button and no pricing dialog.
+ *
+ * @remarks
+ * This indirection keeps the chrome free of any hard dependency on a specific pricing
+ * dialog implementation (e.g. `gdc-pricing-dialog`). The host app supplies
+ * the extension at boot; removing the extension is a one-line change.
+ *
+ * Contract:
+ * - MUST be called once before the first render of `<Root>`.
+ * - The supplied function MUST obey React Rules of Hooks — it is invoked from
+ *   `HostChrome`'s render.
+ * - Swapping or unregistering the extension after first render is unsupported and
+ *   will violate Rules of Hooks.
+ *
+ * @alpha
+ */
+export declare function setHostPricingExtension(extension: UseHostPricingExtension | undefined): void;
+/**
+ * Returns the pricing affordances for the current platform context + locale. Falls
+ * back to a no-op shape when no pricing extension is registered.
+ */
+export declare function useHostChromePricing(ctx: IPlatformContext, locale: string): IHostChromePricing;

package/esm/ui/useHostChromePricing.js

@@ -0,0 +1,37 @@
+// (C) 2026 GoodData Corporation
+let registeredPricingExtension;
+/**
+ * Registers a pricing extension that the default host chrome will consume to render
+ * trial-upgrade affordances. Optional — when no extension is registered, the chrome
+ * shows no upsell button and no pricing dialog.
+ *
+ * @remarks
+ * This indirection keeps the chrome free of any hard dependency on a specific pricing
+ * dialog implementation (e.g. `gdc-pricing-dialog`). The host app supplies
+ * the extension at boot; removing the extension is a one-line change.
+ *
+ * Contract:
+ * - MUST be called once before the first render of `<Root>`.
+ * - The supplied function MUST obey React Rules of Hooks — it is invoked from
+ *   `HostChrome`'s render.
+ * - Swapping or unregistering the extension after first render is unsupported and
+ *   will violate Rules of Hooks.
+ *
+ * @alpha
+ */
+export function setHostPricingExtension(extension) {
+    registeredPricingExtension = extension;
+}
+const NO_PRICING = {
+    element: null,
+    isTrial: false,
+    expiredDate: "",
+    onUpsellButtonClick: () => { },
+};
+/**
+ * Returns the pricing affordances for the current platform context + locale. Falls
+ * back to a no-op shape when no pricing extension is registered.
+ */
+export function useHostChromePricing(ctx, locale) {
+    return registeredPricingExtension ? registeredPricingExtension(ctx, locale) : NO_PRICING;
+}

package/esm/ui/useHostChromeSearch.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from "react";
+import { type IPluggableAppTelemetryCallbacks } from "@gooddata/sdk-pluggable-application-model";
+import { type IHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
+export interface IHostChromeSearch {
+    /** The `<SemanticSearch>` element to mount in the header, or `null` when gated off. */
+    element: ReactNode;
+}
+export interface IUseHostChromeSearchArgs {
+    features: IHostChromeWorkspaceFeatures;
+    isTrial: boolean;
+    onAskAiAssistant: (question: string) => void;
+    telemetry: IPluggableAppTelemetryCallbacks | undefined;
+}
+/**
+ * Builds the semantic-search element rendered in the host chrome header.
+ *
+ * Forwards search events to the host telemetry callbacks and wires the AI-assistant
+ * footer button so it can hand the user's question to the chat hook.
+ */
+export declare function useHostChromeSearch({ features, isTrial, onAskAiAssistant, telemetry }: IUseHostChromeSearchArgs): IHostChromeSearch;

package/esm/ui/useHostChromeSearch.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useCallback } from "react";
+import { getBackend } from "../platformContext/backend.js";
+import { SemanticSearch } from "./SemanticSearch.js";
+/**
+ * Builds the semantic-search element rendered in the host chrome header.
+ *
+ * Forwards search events to the host telemetry callbacks and wires the AI-assistant
+ * footer button so it can hand the user's question to the chat hook.
+ */
+export function useHostChromeSearch({ features, isTrial, onAskAiAssistant, telemetry, }) {
+    const handleSearchEvent = useCallback((event) => {
+        telemetry?.trackEvent(event.name, event.payload);
+    }, [telemetry]);
+    const element = features.showSearch && features.workspaceId ? (_jsx(SemanticSearch, { backend: getBackend(), workspaceId: features.workspaceId, canManage: features.canManageProject, canAnalyze: features.canCreateVisualization, canFullControl: features.canFullControl, metadataTimeZone: features.settings.metadataTimeZone, isTrial: isTrial, enableUseGenAIChat: features.showChat, useHostedMetricEditor: Boolean(features.settings.enableShellApplication_metricEditor), onAskAiAssistant: onAskAiAssistant, onEvent: handleSearchEvent })) : null;
+    return { element };
+}

package/esm/ui/useHostChromeWorkspaceFeatures.d.ts

@@ -0,0 +1,19 @@
+import { type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type IEffectiveSettings, type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+export interface IHostChromeWorkspaceFeatures {
+    isWorkspaceApp: boolean;
+    workspaceId: string | undefined;
+    settings: IEffectiveSettings;
+    canUseAiAssistant: boolean;
+    canManageProject: boolean;
+    canCreateVisualization: boolean;
+    canAccessWorkbench: boolean;
+    canFullControl: boolean;
+    showSearch: boolean;
+    showChat: boolean;
+}
+/**
+ * Computes the workspace-app gate plus the matrix of permissions and settings the host
+ * chrome needs to decide whether to render search, chat, etc.
+ */
+export declare function useHostChromeWorkspaceFeatures(resolvedApplications: PluggableApplicationRegistryItem[], ctx: IPlatformContext, pathname: string): IHostChromeWorkspaceFeatures;

package/esm/ui/useHostChromeWorkspaceFeatures.js

@@ -0,0 +1,36 @@
+// (C) 2026 GoodData Corporation
+import { useMemo } from "react";
+import { getActiveInternalApplication, getWorkspaceIdFromPath } from "../loader/routing.js";
+/**
+ * Computes the workspace-app gate plus the matrix of permissions and settings the host
+ * chrome needs to decide whether to render search, chat, etc.
+ */
+export function useHostChromeWorkspaceFeatures(resolvedApplications, ctx, pathname) {
+    const activeApp = useMemo(() => getActiveInternalApplication(resolvedApplications, ctx, pathname), [resolvedApplications, ctx, pathname]);
+    return useMemo(() => {
+        const isWorkspaceApp = activeApp?.applicationScope === "workspace";
+        const workspaceId = getWorkspaceIdFromPath(pathname);
+        const settings = ctx.settings;
+        const enableSemanticSearch = !!settings.enableSemanticSearch;
+        const enableGenAIChat = !!settings.enableGenAIChat;
+        const canUseAiAssistant = !!ctx.workspacePermissions?.canUseAiAssistant;
+        const canManageProject = !!ctx.workspacePermissions?.canManageProject;
+        const canCreateVisualization = !!ctx.workspacePermissions?.canCreateVisualization;
+        const canAccessWorkbench = !!ctx.workspacePermissions?.canAccessWorkbench;
+        const canFullControl = !!ctx.organizationPermissions?.canManageOrganization;
+        const showSearch = isWorkspaceApp && !!workspaceId && enableSemanticSearch;
+        const showChat = isWorkspaceApp && !!workspaceId && enableGenAIChat && canUseAiAssistant;
+        return {
+            isWorkspaceApp,
+            workspaceId,
+            settings,
+            canUseAiAssistant,
+            canManageProject,
+            canCreateVisualization,
+            canAccessWorkbench,
+            canFullControl,
+            showSearch,
+            showChat,
+        };
+    }, [activeApp, ctx, pathname]);
+}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@gooddata/sdk-ui-pluggable-host",
+  "version": "11.40.0-alpha.3",
+  "description": "GoodData SDK runtime for hosting pluggable applications — registry, loader, routing, platform context, default UI chrome",
+  "license": "MIT",
+  "author": "GoodData Corporation",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gooddata/gooddata-ui-sdk.git",
+    "directory": "libs/sdk-ui-pluggable-host"
+  },
+  "files": [
+    "esm/**/*.js",
+    "esm/**/*.json",
+    "esm/**/*.d.ts",
+    "esm/**/*.map",
+    "esm/**/*.css",
+    "esm/**/*.scss",
+    "esm/**/*.svg"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ],
+  "browser": "./esm/index.js",
+  "types": "./esm/index.d.ts",
+  "exports": "./esm/index.js",
+  "dependencies": {
+    "@module-federation/runtime": "2.3.1",
+    "lodash-es": "^4.17.23",
+    "@gooddata/sdk-backend-base": "11.40.0-alpha.3",
+    "@gooddata/sdk-backend-spi": "11.40.0-alpha.3",
+    "@gooddata/sdk-backend-tiger": "11.40.0-alpha.3",
+    "@gooddata/sdk-model": "11.40.0-alpha.3",
+    "@gooddata/sdk-pluggable-application-model": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-application-header": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-ext": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-gen-ai": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-kit": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-semantic-search": "11.40.0-alpha.3",
+    "@gooddata/sdk-ui-theme-provider": "11.40.0-alpha.3",
+    "@gooddata/util": "11.40.0-alpha.3"
+  },
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.17.0",
+    "@microsoft/api-extractor": "^7.55.2",
+    "@testing-library/dom": "10.4.1",
+    "@testing-library/react": "16.3.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "24.12.0",
+    "@types/react": "19.1.11",
+    "@types/react-dom": "19.1.7",
+    "@typescript-eslint/eslint-plugin": "8.58.0",
+    "@typescript-eslint/parser": "8.58.0",
+    "@typescript/native-preview": "7.0.0-dev.20260202.1",
+    "@vitest/coverage-v8": "4.1.0",
+    "@vitest/eslint-plugin": "1.6.6",
+    "eslint": "^9.39.2",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-headers": "1.3.3",
+    "eslint-plugin-import-x": "4.16.1",
+    "eslint-plugin-jsdoc": "62.1.0",
+    "eslint-plugin-no-barrel-files": "1.2.2",
+    "eslint-plugin-no-only-tests": "3.3.0",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "5.2.0",
+    "eslint-plugin-sonarjs": "3.0.6",
+    "happy-dom": "18.0.1",
+    "jiti": "2.6.1",
+    "npm-run-all": "^4.1.5",
+    "oxfmt": "0.45.0",
+    "oxlint": "^1.43.0",
+    "oxlint-tsgolint": "0.11.4",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
+    "react-intl": "7.1.11",
+    "react-router": "7.13.1",
+    "rolldown": "1.0.0-rc.9",
+    "sass": "1.70.0",
+    "tslib": "2.8.1",
+    "typescript": "5.9.3",
+    "vite": "8.0.0",
+    "vitest": "4.1.0",
+    "vitest-dom": "0.1.1",
+    "@gooddata/eslint-config": "11.40.0-alpha.3",
+    "@gooddata/oxlint-config": "11.40.0-alpha.3"
+  },
+  "peerDependencies": {
+    "react": ">=18.3.1",
+    "react-dom": ">=18.3.1",
+    "react-intl": ">=7",
+    "react-router": ">=7"
+  },
+  "scripts": {
+    "_phase:build": "npm run build",
+    "_phase:test": "npm run test-once",
+    "_phase:validate": "npm run validate",
+    "api-extractor": "mkdir -p api && [ -z \"${CI}\" ] && (api-extractor run -l) || (api-extractor run)",
+    "build": "npm-run-all -p build-check build-ts && npm run copy-assets && npm run api-extractor",
+    "build-check": "tsgo",
+    "build-ts": "tsgo -p ./tsconfig.build.json",
+    "clean": "../../common/scripts/clean-command-state.sh && rm -rf esm *.log",
+    "copy-assets": "bash scripts/copy-assets.sh",
+    "format-check": "oxfmt --check .",
+    "format-write": "oxfmt .",
+    "lint": "oxlint . --type-aware --quiet && eslint .",
+    "lint-fix": "oxlint . --type-aware --quiet --fix && eslint . --fix",
+    "test": "vitest",
+    "test-once": "vitest run",
+    "validate": "npm run lint && npm run format-check"
+  }
+}