@gooddata/create-pluggable-module 11.40.0-alpha.3

package/dist/templates/module/src/App.test.tsx

@@ -0,0 +1,53 @@
+// (C) 2026 GoodData Corporation
+
+import { render, screen } from "@testing-library/react";
+import { IntlProvider } from "react-intl";
+import { describe, expect, it } from "vitest";
+
+import { BackendProvider } from "@gooddata/sdk-ui";
+import { PlatformContextProvider, type IClientPlatformContext } from "@gooddata/sdk-ui-pluggable-application";
+
+import { App } from "./App.js";
+
+function createMockCtx(): IClientPlatformContext {
+    return {
+        version: "1.0",
+        auth: { type: "contextDeferred" },
+        user: { login: "test@example.com" },
+        organization: { id: "org-1", title: "Test Org" },
+        userSettings: {} as IClientPlatformContext["userSettings"],
+        whiteLabeling: undefined,
+        embeddingMode: "none",
+        backend: {
+            // Minimal mock — extend as needed for your tests
+        } as IClientPlatformContext["backend"],
+    } as IClientPlatformContext;
+}
+
+function renderWithProviders(ui: React.ReactElement) {
+    const ctx = createMockCtx();
+    return render(
+        <PlatformContextProvider value={ctx}>
+            <BackendProvider backend={ctx.backend}>
+                <IntlProvider
+                    locale="en-US"
+                    messages={{ "gdc-app-template-name.title": "{applicationTemplateTitle}" }}
+                >
+                    {ui}
+                </IntlProvider>
+            </BackendProvider>
+        </PlatformContextProvider>,
+    );
+}
+
+describe("App", () => {
+    it("renders the application title", () => {
+        renderWithProviders(<App />);
+        expect(screen.getByText("{applicationTemplateTitle}")).toBeTruthy();
+    });
+
+    it("renders user information from context", () => {
+        renderWithProviders(<App />);
+        expect(screen.getByText(/test@example.com/)).toBeTruthy();
+    });
+});

package/dist/templates/module/src/App.tsx

@@ -0,0 +1,34 @@
+// (C) 2026 GoodData Corporation
+
+import { FormattedMessage } from "react-intl";
+
+import {
+    type IPluggableAppEvent,
+    type IPluggableAppTelemetryCallbacks,
+} from "@gooddata/sdk-pluggable-application-model";
+import { useWorkspace } from "@gooddata/sdk-ui";
+import { usePlatformContextStrict } from "@gooddata/sdk-ui-pluggable-application";
+
+interface IAppProps {
+    onEvent?: (e: IPluggableAppEvent) => void;
+    onTelemetryEvent?: IPluggableAppTelemetryCallbacks;
+}
+
+export function App({ onEvent: _onEvent, onTelemetryEvent: _onTelemetryEvent }: IAppProps) {
+    const ctx = usePlatformContextStrict();
+    const workspaceId = useWorkspace();
+
+    return (
+        <div>
+            <h1>
+                <FormattedMessage id="gdc-app-template-name.title" />
+            </h1>
+            <p>Your pluggable application is running.</p>
+            <ul>
+                <li>User: {ctx.user.login}</li>
+                <li>Organization: {ctx.organization?.title ?? ctx.organization?.id ?? "n/a"}</li>
+                {workspaceId ? <li>Workspace: {workspaceId}</li> : null}
+            </ul>
+        </div>
+    );
+}

package/dist/templates/module/src/AppProviders.tsx

@@ -0,0 +1,26 @@
+// (C) 2026 GoodData Corporation
+
+import { type PropsWithChildren } from "react";
+
+import { type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+import { AppProviders as SdkAppProviders } from "@gooddata/sdk-ui-pluggable-application";
+
+import { DEFAULT_LANGUAGE, DEFAULT_MESSAGES, resolveMessages } from "./translations/translations.js";
+
+interface IAppProvidersProps {
+    ctx: IPlatformContext;
+}
+
+export function AppProviders({ ctx, children }: PropsWithChildren<IAppProvidersProps>) {
+    return (
+        <SdkAppProviders
+            ctx={ctx}
+            packageName="gdc-app-template-name-module"
+            resolveMessages={resolveMessages}
+            defaultMessages={DEFAULT_MESSAGES}
+            defaultLanguage={DEFAULT_LANGUAGE}
+        >
+            {children}
+        </SdkAppProviders>
+    );
+}

package/dist/templates/module/src/index.ts

@@ -0,0 +1,3 @@
+// (C) 2026 GoodData Corporation
+
+export { pluggableApp } from "./pluggableApp.js";

package/dist/templates/module/src/pluggableApp.tsx

@@ -0,0 +1,56 @@
+// (C) 2026 GoodData Corporation
+
+import { createRoot, type Root } from "react-dom/client";
+
+import {
+    type IPluggableApp,
+    type IPluggableApplicationMountHandle,
+    type IPluggableApplicationMountOptions,
+    type IPluggableAppEvent,
+    type IPluggableAppTelemetryCallbacks,
+    type IPlatformContext,
+} from "@gooddata/sdk-pluggable-application-model";
+
+import { App } from "./App.js";
+import { AppProviders } from "./AppProviders.js";
+
+function renderApp(
+    root: Root,
+    ctx: IPlatformContext,
+    _basePath: string,
+    onEvent: ((e: IPluggableAppEvent) => void) | undefined,
+    onTelemetryEvent: IPluggableAppTelemetryCallbacks | undefined,
+) {
+    root.render(
+        <AppProviders ctx={ctx}>
+            <App onEvent={onEvent} onTelemetryEvent={onTelemetryEvent} />
+        </AppProviders>,
+    );
+}
+
+export const pluggableApp: IPluggableApp = {
+    mount({
+        container,
+        ctx,
+        basePath,
+        onEvent,
+        onTelemetryEvent,
+    }: IPluggableApplicationMountOptions): IPluggableApplicationMountHandle {
+        // To customize the host header (e.g. add app-specific help menu items),
+        // destructure `onHeaderChange` from the mount options and call:
+        //   onHeaderChange?.({ helpMenuItems: [...] });
+        // See modules/gdc-catalog/module/src/pluggableApp.tsx for a working example.
+        const root = createRoot(container);
+
+        renderApp(root, ctx, basePath, onEvent, onTelemetryEvent);
+
+        return {
+            unmount() {
+                root.unmount();
+            },
+            updateContext(nextCtx: IPlatformContext) {
+                renderApp(root, nextCtx, basePath, onEvent, onTelemetryEvent);
+            },
+        };
+    },
+};

package/dist/templates/module/src/translations/de-DE.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/en-AU.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/en-GB.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/en-US.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/es-419.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/es-ES.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/fi-FI.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/fr-CA.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/fr-FR.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/id-ID.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/it-IT.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/ja-JP.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/ko-KR.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/nl-NL.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/pl-PL.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/pt-BR.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/pt-PT.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/ru-RU.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/sl-SI.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/th-TH.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/tr-TR.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/translations.ts

@@ -0,0 +1,71 @@
+// (C) 2026 GoodData Corporation
+
+import { memoize } from "lodash-es";
+
+import {
+    type ILocale,
+    type ITranslations,
+    DEFAULT_MESSAGES as SDK_DEFAULT_MESSAGES,
+    resolveMessages as resolveSdkMessages,
+} from "@gooddata/sdk-ui";
+import { removeMetadata } from "@gooddata/util";
+
+import en_US from "./en-US.json" with { type: "json" };
+
+export const DEFAULT_LANGUAGE: ILocale = "en-US";
+export const DEFAULT_MESSAGES: Record<string, ITranslations> = {
+    [DEFAULT_LANGUAGE]: {
+        ...SDK_DEFAULT_MESSAGES[DEFAULT_LANGUAGE],
+        ...removeMetadata(en_US),
+    },
+};
+
+const loadLocale = (importFn: () => Promise<{ default: unknown }>): (() => Promise<ITranslations>) => {
+    return () => importFn().then((module) => removeMetadata(module.default || module));
+};
+
+type LocaleOptions = Record<ILocale, () => Promise<ITranslations>>;
+
+const asyncComponentTranslations: LocaleOptions = {
+    "en-US": () => Promise.resolve(removeMetadata(en_US)),
+    "en-US-x-24h": () => Promise.resolve(removeMetadata(en_US)),
+    "de-DE": loadLocale(() => import("./de-DE.json")),
+    "en-AU": loadLocale(() => import("./en-AU.json")),
+    "en-GB": loadLocale(() => import("./en-GB.json")),
+    "es-419": loadLocale(() => import("./es-419.json")),
+    "es-ES": loadLocale(() => import("./es-ES.json")),
+    "fi-FI": loadLocale(() => import("./fi-FI.json")),
+    "fr-CA": loadLocale(() => import("./fr-CA.json")),
+    "fr-FR": loadLocale(() => import("./fr-FR.json")),
+    "id-ID": loadLocale(() => import("./id-ID.json")),
+    "it-IT": loadLocale(() => import("./it-IT.json")),
+    "ja-JP": loadLocale(() => import("./ja-JP.json")),
+    "ko-KR": loadLocale(() => import("./ko-KR.json")),
+    "nl-NL": loadLocale(() => import("./nl-NL.json")),
+    "pl-PL": loadLocale(() => import("./pl-PL.json")),
+    "pt-BR": loadLocale(() => import("./pt-BR.json")),
+    "pt-PT": loadLocale(() => import("./pt-PT.json")),
+    "ru-RU": loadLocale(() => import("./ru-RU.json")),
+    "sl-SI": loadLocale(() => import("./sl-SI.json")),
+    "th-TH": loadLocale(() => import("./th-TH.json")),
+    "tr-TR": loadLocale(() => import("./tr-TR.json")),
+    "vi-VN": loadLocale(() => import("./vi-VN.json")),
+    "zh-Hans": loadLocale(() => import("./zh-Hans.json")),
+    "zh-Hant": loadLocale(() => import("./zh-Hant.json")),
+    "uk-UA": loadLocale(() => import("./uk-UA.json")),
+    "zh-HK": loadLocale(() => import("./zh-HK.json")),
+};
+
+const resolveMessagesInternal = async (locale: string): Promise<ITranslations> => {
+    const componentLoader =
+        asyncComponentTranslations[locale as ILocale] || asyncComponentTranslations[DEFAULT_LANGUAGE];
+
+    const [componentMessages, sdkMessages] = await Promise.all([
+        componentLoader(),
+        resolveSdkMessages(locale),
+    ]);
+
+    return { ...sdkMessages, ...componentMessages };
+};
+
+export const resolveMessages: (locale: string) => Promise<ITranslations> = memoize(resolveMessagesInternal);

package/dist/templates/module/src/translations/uk-UA.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/vi-VN.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/zh-HK.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/zh-Hans.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/src/translations/zh-Hant.json

@@ -0,0 +1,6 @@
+{
+    "gdc-app-template-name.title": {
+        "text": "{applicationTemplateTitle}",
+        "crowdinContext": "Application title displayed in the navigation menu"
+    }
+}

package/dist/templates/module/tsconfig.json

@@ -0,0 +1,65 @@
+{
+    "compilerOptions": {
+        "strict": true,
+        "noFallthroughCasesInSwitch": true,
+        "noImplicitOverride": true,
+        "noPropertyAccessFromIndexSignature": true,
+        "exactOptionalPropertyTypes": false,
+        "useUnknownInCatchVariables": true,
+        "noUncheckedIndexedAccess": false,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "allowUnreachableCode": false,
+        "allowUnusedLabels": false,
+        "noImplicitReturns": true,
+        "alwaysStrict": true,
+        "forceConsistentCasingInFileNames": true,
+        "lib": [
+            "es2022",
+            "dom",
+            "dom.iterable"
+        ],
+        "target": "es2022",
+        "skipLibCheck": true,
+        "esModuleInterop": true,
+        "module": "nodenext",
+        "moduleResolution": "nodenext",
+        "importHelpers": true,
+        "incremental": false,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "jsx": "react-jsx",
+        "allowJs": true,
+        "noEmit": true,
+        "outDir": "./dist",
+        "moduleDetection": "force",
+        "allowSyntheticDefaultImports": true,
+        "resolvePackageJsonExports": true,
+        "resolvePackageJsonImports": true,
+        "useDefineForClassFields": true,
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true,
+        "strictBuiltinIteratorReturn": true
+    },
+    "files": [
+        "./eslint.config.ts",
+        "./vite.config.ts",
+        "./vitest.config.ts",
+        "./src/App.test.tsx",
+        "./src/App.tsx",
+        "./src/AppProviders.tsx",
+        "./src/index.ts",
+        "./src/pluggableApp.tsx",
+        "./src/translations/translations.ts"
+    ],
+    "exclude": [
+        "**/node_modules",
+        "**/esm",
+        "**/temp",
+        "**/dist"
+    ]
+}

package/dist/templates/module/vite.config.ts

@@ -0,0 +1,140 @@
+// (C) 2026 GoodData Corporation
+
+//
+// Pluggable-only build: produces the Module Federation artifacts
+// (remoteEntry.js + pluggableApp chunks) needed by the host app.
+//
+// One artifact, two publish targets: with `base: "./"` the same dist/
+// works whether served from host nginx (/organization/remotes/<app>/)
+// or from S3 (https://<bucket>/<prefix>/<app>/).
+//
+// Local dev (module federation):
+//   `vite build --watch`   (terminal 1)
+//   `vite preview`         (terminal 2)
+// Note: day-to-day development is faster via the sibling harness/,
+// which imports the module source directly without federation.
+//
+// Build:
+//   `vite build` → dist/
+//
+
+import { execSync } from "child_process";
+import { readFileSync } from "fs";
+import { join, resolve } from "path";
+
+import { federation } from "@module-federation/vite";
+import react from "@vitejs/plugin-react";
+import { type UserConfig, defaultClientConditions, defineConfig, loadEnv } from "vite";
+
+function tryExecSync(command: string, fallback: string): string {
+    try {
+        return execSync(command, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim() || fallback;
+    } catch {
+        return fallback;
+    }
+}
+
+function gitRevisionPlugin() {
+    const commitHash = tryExecSync("git rev-parse HEAD --quiet", process.env["GIT_COMMIT"] ?? "dev");
+
+    return {
+        name: "git-revision",
+        config() {
+            return {
+                define: {
+                    "window.COMMITHASH": JSON.stringify(commitHash),
+                },
+            };
+        },
+    };
+}
+
+const certDir = join(process.env["HOME"] || process.env["USERPROFILE"] || "", ".gooddata", "certs");
+let httpsConfig: import("vite").ServerOptions["https"] | undefined;
+
+try {
+    httpsConfig = {
+        ca: readFileSync(join(certDir, "rootCA.pem")),
+        key: readFileSync(join(certDir, "localhost-key.pem")),
+        cert: readFileSync(join(certDir, "localhost-cert.pem")),
+    };
+    // oxlint-disable-next-line @typescript-eslint/no-unused-vars
+} catch (e) {
+    // eslint-disable-next-line no-console
+    console.info(`No certificates found in ${certDir}, skipping HTTPS configuration`);
+    httpsConfig = undefined;
+}
+
+// eslint-disable-next-line no-restricted-exports
+export default defineConfig(({ mode, command }): UserConfig => {
+    const env = loadEnv(mode, process.cwd(), "");
+    const port = parseInt(env["PORT"] || "{modulePort}");
+    const isDev = command === "serve"; // dev server only
+
+    return {
+        root: ".",
+        // Relative base so asset URLs resolve via import.meta.url at runtime,
+        // allowing the remote to be served from any path (nginx, S3, CDN)
+        // without coupling to a specific host URL.
+        base: "./",
+        publicDir: false,
+        resolve: {
+            // resolve.conditions REPLACES Vite's defaults rather than extending them
+            // (Vite 8's mergeWithDefaultsRecursively assigns arrays directly), so we must
+            // spread defaultClientConditions to keep "browser" / "module" / dev-prod
+            // resolution. Without "browser", packages like react-textarea-autosize fall
+            // through to their node-targeted default export (a stub that ignores
+            // minRows/maxRows).
+            // `source` is added only in dev so production builds use the published
+            // artifacts of workspace deps, not their TS source.
+            conditions: [...defaultClientConditions, ...(isDev ? ["source"] : [])],
+            dedupe: [
+                "@gooddata/sdk-ui",
+                "@gooddata/sdk-ui-kit",
+                "@gooddata/sdk-ui-ext",
+                "react",
+                "react-dom",
+            ],
+        },
+        define: {
+            REACT_APP_SDK_BACKEND: JSON.stringify("TIGER"),
+            PRODUCTION: JSON.stringify(mode === "production"),
+            "process.env": JSON.stringify({}),
+        },
+        // `vite preview` serves dist/ for local dev against the host app.
+        preview: {
+            port,
+            https: httpsConfig,
+            cors: true,
+        },
+        build: {
+            outDir: "dist",
+            sourcemap: mode !== "production",
+            target: "es2022",
+            chunkSizeWarningLimit: 10000,
+            rolldownOptions: {
+                input: resolve(__dirname, "src/pluggableApp.tsx"),
+                output: {
+                    entryFileNames: "static/js/[name].[hash].js",
+                    chunkFileNames: "static/js/[name].[hash].chunk.js",
+                    assetFileNames: "static/[hash][extname]",
+                },
+            },
+        },
+        plugins: [
+            federation({
+                name: "{applicationTemplateFederationName}",
+                filename: "remoteEntry.js",
+                dts: false,
+                exposes: {
+                    "./pluggableApp": "./src/pluggableApp.tsx",
+                },
+                // Use idle-based timeout instead of the default 10s absolute deadline,
+                // which flakes on loaded CI runners when the transform is slow but progressing.
+                moduleParseIdleTimeout: 60,
+            }),
+            react(),
+            gitRevisionPlugin(),
+        ],
+    };
+});