@openmrs/esm-app-shell 10.0.1-pre.5635 → 10.0.1-pre.5649

package/src/run.test.ts

@@ -1,30 +1,49 @@
-// Boot is left pending forever so the only error page these tests can see is the one raised by a
-// failed session fetch, not the one `handleInitFailure` renders for a failed startup.
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+// Boot stays pending until a test calls `harness.boot()`, and a started boot always succeeds, so the only
+// error page these tests can see is the one raised by a failed session fetch, not the one
+// `handleInitFailure` renders for a failed startup.
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 interface SessionState {
   loaded: boolean;
   session: unknown;
   error?: Error;
+  initializing?: boolean;
 }
 
-const harness = vi.hoisted(() => ({
-  listeners: new Set<(state: SessionState) => void>(),
-  push(state: SessionState) {
-    this.listeners.forEach((listener) => listener(state));
-  },
-}));
+const harness = vi.hoisted(() => {
+  let releaseBoot: () => void = () => {};
+  return {
+    refetchCurrentUser: vi.fn(() => Promise.reject()),
+    removeServerStartingPage: vi.fn(),
+    renderServerStartingPage: vi.fn(),
+    listeners: new Set<(state: SessionState) => void>(),
+    state: { loaded: false, session: null } as SessionState,
+    bootGate: Promise.resolve(),
+    reset() {
+      this.listeners.clear();
+      this.state = { loaded: false, session: null };
+      this.bootGate = new Promise<void>((resolve) => (releaseBoot = resolve));
+    },
+    boot() {
+      releaseBoot();
+    },
+    push(state: SessionState) {
+      this.state = state;
+      this.listeners.forEach((listener) => listener(state));
+    },
+  };
+});
 
 vi.mock('@openmrs/esm-framework/src/internal', () => {
   const noop = () => {};
   return {
     finishRegisteringAllApps: noop,
     fireOpenmrsEvent: noop,
-    getConfig: noop,
+    getConfig: async () => ({ preferredCalendar: {} }),
     getCoreTranslation: noop,
-    getCurrentRouteMap: noop,
+    getCurrentRouteMap: async () => ({ routes: {} }),
     getSessionStore: () => ({
-      getState: () => ({ loaded: false, session: null }),
+      getState: () => harness.state,
       subscribe: (listener: (state: SessionState) => void) => {
         harness.listeners.add(listener);
         return () => harness.listeners.delete(listener);
@@ -32,7 +51,9 @@ vi.mock('@openmrs/esm-framework/src/internal', () => {
     }),
     integrateBreakpoints: noop,
     interpolateUrl: (url: string) => url,
+    makeUrl: (path: string) => `/openmrs${path}`,
     provide: noop,
+    refetchCurrentUser: harness.refetchCurrentUser,
     registerApp: noop,
     registerDefaultCalendar: noop,
     renderActionableNotifications: noop,
@@ -45,7 +66,7 @@ vi.mock('@openmrs/esm-framework/src/internal', () => {
     setupHistory: noop,
     setupImportMapOverrides: noop,
     setupModals: noop,
-    setupRouteMapOverrides: () => new Promise(() => {}),
+    setupRouteMapOverrides: () => harness.bootGate,
     showActionableNotification: noop,
     showNotification: noop,
     showSnackbar: noop,
@@ -59,20 +80,30 @@ vi.mock('@openmrs/esm-framework/src/internal', () => {
 });
 
 vi.mock('single-spa', () => ({ start: () => {} }));
+// Node has no `Intl.DurationFormat`, and fake timers can't flush the dynamic import `run()` loads the polyfill with.
+vi.mock('@formatjs/intl-durationformat/lib/polyfill', () => ({}));
 vi.mock('@openmrs/esm-styleguide/src/index', () => ({ setupStyleguide: () => {} }));
 vi.mock('./locale', () => ({ setupI18n: () => {} }));
+vi.mock('./static-page-translations', () => ({ translateStaticPage: () => {} }));
 vi.mock('./routing-events', () => ({}));
 vi.mock('./events', () => ({}));
 vi.mock('./ui', () => ({ appName: '@openmrs/esm-app-shell', getCoreExtensions: () => [] }));
+vi.mock('./ui/server-starting.component', () => ({ renderServerStartingPage: harness.renderServerStartingPage }));
 vi.mock('./core-config', () => ({ setupCoreConfig: () => {} }));
 
 import { run } from './run';
 
 const errorPage = () => document.querySelector('.omrs-app-error');
+const startingUp: SessionState = {
+  loaded: false,
+  session: null,
+  error: new Error('The server is still starting up'),
+  initializing: true,
+};
 
 describe('the session error page', () => {
   beforeEach(() => {
-    harness.listeners.clear();
+    harness.reset();
     document.body.innerHTML = `
       <template id="app-error">
         <div class="omrs-app-error"><code data-var="message"></code></div>
@@ -108,4 +139,123 @@ describe('the session error page', () => {
     expect(errorPage()).toBeNull();
     expect(harness.listeners.size).toBe(0);
   });
+
+  it('copies only the error message and briefly shows that it was copied', () => {
+    vi.useFakeTimers();
+    const copyText = vi.fn();
+    vi.stubGlobal('copyText', copyText);
+    document.body.innerHTML = `
+      <template id="app-error">
+        <div class="omrs-app-error">
+          <code data-var="message"></code>
+          <span class="cds--popover-container"><button data-copy-btn></button><span>Copied!</span></span>
+        </div>
+      </template>`;
+    harness.push({ loaded: false, session: null, error: new Error('Bad Gateway') });
+
+    document.querySelector<HTMLButtonElement>('[data-copy-btn]')!.click();
+    expect(copyText).toHaveBeenCalledWith(document.querySelector('.omrs-app-error code'));
+    expect(document.querySelector('.cds--popover-container')).toHaveClass('cds--popover--open');
+
+    vi.advanceTimersByTime(2000);
+    expect(document.querySelector('.cds--popover-container')).not.toHaveClass('cds--popover--open');
+    vi.useRealTimers();
+  });
+});
+
+describe('the server starting page', () => {
+  // A successful boot defines non-configurable globals, so they are made configurable here to let each
+  // test boot again.
+  const defineProperty = Object.defineProperty;
+  let defineSpy: { mockRestore(): void };
+
+  beforeEach(() => {
+    defineSpy = vi
+      .spyOn(Object, 'defineProperty')
+      .mockImplementation((target, key, descriptor) =>
+        defineProperty(target, key, target === window ? { ...descriptor, configurable: true } : descriptor),
+      );
+    delete (window as any).installedModules;
+    delete (window as any).applicationVersion;
+    vi.useFakeTimers();
+    harness.reset();
+    harness.refetchCurrentUser.mockClear();
+    harness.renderServerStartingPage.mockReset().mockReturnValue(harness.removeServerStartingPage);
+    harness.removeServerStartingPage.mockClear();
+    document.body.innerHTML = `
+      <template id="app-error">
+        <div class="omrs-app-error"><code data-var="message"></code></div>
+      </template>`;
+    vi.stubGlobal('fetch', () => new Promise(() => {}));
+    run([]);
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+    defineSpy.mockRestore();
+  });
+
+  const finishBoot = async () => {
+    harness.boot();
+    await vi.advanceTimersByTimeAsync(0);
+  };
+
+  it('waits for the app to boot before it is shown', async () => {
+    harness.push(startingUp);
+    expect(harness.renderServerStartingPage).not.toHaveBeenCalled();
+    expect(errorPage()).toBeNull();
+
+    await finishBoot();
+    expect(harness.renderServerStartingPage).toHaveBeenCalledTimes(1);
+  });
+
+  it('is shown once when the server is still starting after boot', async () => {
+    await finishBoot();
+    harness.push(startingUp);
+    harness.push(startingUp);
+
+    expect(harness.renderServerStartingPage).toHaveBeenCalledTimes(1);
+    expect(errorPage()).toBeNull();
+  });
+
+  it('polls the session while the server is starting up, even before boot finishes', async () => {
+    harness.push(startingUp);
+    harness.push(startingUp);
+    expect(harness.refetchCurrentUser).not.toHaveBeenCalled();
+
+    await vi.advanceTimersByTimeAsync(5000);
+    expect(harness.refetchCurrentUser).toHaveBeenCalledTimes(1);
+
+    harness.push(startingUp);
+    await vi.advanceTimersByTimeAsync(5000);
+    expect(harness.refetchCurrentUser).toHaveBeenCalledTimes(2);
+  });
+
+  it('is taken down when the session loads', async () => {
+    await finishBoot();
+    harness.push(startingUp);
+    harness.push({ loaded: true, session: { authenticated: false } });
+    await vi.advanceTimersByTimeAsync(5000);
+
+    expect(harness.removeServerStartingPage).toHaveBeenCalledTimes(1);
+    expect(harness.refetchCurrentUser).not.toHaveBeenCalled();
+    expect(harness.listeners.size).toBe(0);
+  });
+
+  it('is never shown if the session loads before boot finishes', async () => {
+    harness.push(startingUp);
+    harness.push({ loaded: true, session: { authenticated: false } });
+    await finishBoot();
+
+    expect(harness.renderServerStartingPage).not.toHaveBeenCalled();
+  });
+
+  it('is replaced by the error page when the session fails for another reason', async () => {
+    await finishBoot();
+    harness.push(startingUp);
+    harness.push({ loaded: false, session: null, error: new Error('Bad Gateway') });
+
+    expect(harness.removeServerStartingPage).toHaveBeenCalledTimes(1);
+    expect(errorPage()?.textContent).toBe('Bad Gateway');
+  });
 });

package/src/run.ts

@@ -12,7 +12,9 @@ import {
   integrateBreakpoints,
   interpolateUrl,
   type OpenmrsRoutes,
+  type SessionStore,
   provide,
+  refetchCurrentUser,
   registerApp,
   registerDefaultCalendar,
   renderActionableNotifications,
@@ -39,12 +41,14 @@ import {
 } from '@openmrs/esm-framework/src/internal';
 import { setupStyleguide } from '@openmrs/esm-styleguide/src/index';
 import { setupI18n } from './locale';
+import { translateStaticPage } from './static-page-translations';
 // imported so we create the MF shares for these
 import 'swr/mutation';
 import 'swr/subscription';
 import './routing-events';
 import './events';
 import { appName, getCoreExtensions } from './ui';
+import { renderServerStartingPage } from './ui/server-starting.component';
 import { setupCoreConfig } from './core-config';
 
 // @internal
@@ -132,20 +136,60 @@ function handleInitFailure(e: Error) {
   renderFatalErrorPage(e);
 }
 
+const initializingPollIntervalMillis = 5000;
+
 /**
  * No app can render without a session, so a session fetch that fails before any session has loaded
  * gets the same error page as a failed startup. Reading the session store retries the fetch, so the
  * page is taken down again if a later fetch succeeds, e.g. once a backend that was starting up is ready.
+ *
+ * A backend that is still running its initial setup gets a "starting up" page instead, and the session
+ * is refetched periodically until setup finishes or the fetch fails some other way. That page is built
+ * from the framework, so it waits for `booted`; until then, the boot spinner stays up.
  */
-function showErrorPageOnSessionFailure() {
-  let removeErrorPage: (() => void) | undefined;
-  const unsubscribe = getSessionStore().subscribe((state) => {
+function showErrorPageOnSessionFailure(booted: Promise<void>) {
+  let removePage: (() => void) | undefined;
+  let shownPage: 'initializing' | 'error' | undefined;
+  let pollTimer: ReturnType<typeof setTimeout> | undefined;
+  let isBooted = false;
+  let isDone = false;
+
+  const show = (page: typeof shownPage, render: () => (() => void) | undefined) => {
+    if (shownPage !== page) {
+      removePage?.();
+      removePage = render();
+      shownPage = page;
+    }
+  };
+
+  const update = (state: SessionStore) => {
+    if (isDone) {
+      return;
+    }
+
     if (state.loaded) {
+      isDone = true;
       unsubscribe();
-      removeErrorPage?.();
-    } else if (state.error && !removeErrorPage) {
-      removeErrorPage = renderFatalErrorPage(state.error);
+      clearTimeout(pollTimer);
+      removePage?.();
+    } else if (state.initializing) {
+      if (isBooted) {
+        show('initializing', renderServerStartingPage);
+      }
+      pollTimer ??= setTimeout(() => {
+        pollTimer = undefined;
+        refetchCurrentUser().catch(() => {});
+      }, initializingPollIntervalMillis);
+    } else if (state.error) {
+      show('error', () => renderFatalErrorPage(state.error));
     }
+  };
+
+  const sessionStore = getSessionStore();
+  const unsubscribe = sessionStore.subscribe(update);
+  void booted.then(() => {
+    isBooted = true;
+    update(sessionStore.getState());
   });
 }
 
@@ -161,6 +205,11 @@ function renderFatalErrorPage(e?: Error): (() => void) | undefined {
       messageContainer.textContent = e?.message || 'No additional information available.';
     }
 
+    const copyButton = fragment.querySelector<HTMLButtonElement>('[data-copy-btn]');
+    if (copyButton && messageContainer) {
+      copyButton.onclick = () => copyWithFeedback(messageContainer as HTMLElement, copyButton);
+    }
+
     if (
       localStorage.getItem('openmrs:devtools') &&
       Object.keys(localStorage).some((k) => k.startsWith('import-map-override:'))
@@ -170,17 +219,31 @@ function renderFatalErrorPage(e?: Error): (() => void) | undefined {
         const clearDevOverridesButton = document.createElement('button');
         clearDevOverridesButton.className = 'cds--btn';
         clearDevOverridesButton.innerHTML = 'Clear dev overrides';
+        clearDevOverridesButton.dataset.i18n = 'clearDevOverrides';
         clearDevOverridesButton.onclick = clearDevOverrides;
         appErrorActionButtons.appendChild(clearDevOverridesButton);
       }
     }
 
+    translateStaticPage(fragment);
+
     const nodes = Array.from(fragment.childNodes);
     document.body.appendChild(fragment);
     return () => nodes.forEach((node) => node.remove());
   }
 }
 
+const copyFeedbackMillis = 2000;
+
+/** Copies the text of `source` and briefly shows the "Copied!" tooltip attached to `button`. */
+function copyWithFeedback(source: HTMLElement, button: HTMLElement) {
+  window.copyText(source);
+
+  const tooltip = button.closest('.cds--popover-container');
+  tooltip?.classList.add('cds--popover--open');
+  setTimeout(() => tooltip?.classList.remove('cds--popover--open'), copyFeedbackMillis);
+}
+
 function clearDevOverrides() {
   const keysToRemove = Object.keys(localStorage).filter(
     (key) =>
@@ -272,7 +335,9 @@ export function run(configUrls: Array<string>) {
   subscribeToastShown(showToast);
   subscribeSnackbarShown(showSnackbar);
   setupApiModule();
-  showErrorPageOnSessionFailure();
+
+  let markBooted: () => void;
+  showErrorPageOnSessionFailure(new Promise<void>((resolve) => (markBooted = resolve)));
   setupHistory();
   registerCoreExtensions();
   setupCoreConfig();
@@ -290,6 +355,7 @@ export function run(configUrls: Array<string>) {
     .then(() => Promise.resolve(finishRegisteringAllApps()))
     .then(provideConfigs)
     .then(runShell)
+    .then(() => markBooted())
     .catch(handleInitFailure)
     .then(closeLoading)
     .then(() => {

package/src/static-page-translations.test.ts

@@ -0,0 +1,68 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+vi.mock('@openmrs/esm-translations/translations/fr.json', () => ({
+  default: { reload: 'Recharger', copied: '' },
+}));
+
+vi.mock('@openmrs/esm-translations/translations/pt_BR.json', () => ({
+  default: { reload: 'Recarregar' },
+}));
+
+function createPage() {
+  const template = document.createElement('template');
+  template.innerHTML = `
+    <button data-i18n="reload">Reload</button>
+    <span data-i18n="copied">Copied!</span>
+    <span data-i18n="notAKey">Untouched</span>`;
+  return template.content;
+}
+
+async function translate(lang: string) {
+  document.documentElement.setAttribute('lang', lang);
+  // The translations are loaded once per page, so each language needs a fresh module.
+  vi.resetModules();
+  const { translateStaticPage } = await import('./static-page-translations');
+
+  const page = createPage();
+  translateStaticPage(page);
+  await vi.dynamicImportSettled();
+  await new Promise((resolve) => setTimeout(resolve));
+  return page;
+}
+
+describe('translateStaticPage', () => {
+  beforeEach(() => {
+    localStorage.clear();
+  });
+
+  it('replaces the text of tagged elements with the translation for the detected language', async () => {
+    const page = await translate('fr');
+
+    expect(page.querySelector('button')?.textContent).toBe('Recharger');
+  });
+
+  it('keeps the English text for keys that are missing or untranslated', async () => {
+    const page = await translate('fr');
+
+    expect(page.querySelector('[data-i18n="copied"]')?.textContent).toBe('Copied!');
+    expect(page.querySelector('[data-i18n="notAKey"]')?.textContent).toBe('Untouched');
+  });
+
+  it('loads the file named with an underscore for a regional language', async () => {
+    const page = await translate('pt-BR');
+
+    expect(page.querySelector('button')?.textContent).toBe('Recarregar');
+  });
+
+  it('falls back to the base language when there is no regional file', async () => {
+    const page = await translate('fr-CA');
+
+    expect(page.querySelector('button')?.textContent).toBe('Recharger');
+  });
+
+  it('keeps the English text when the language has no translations', async () => {
+    const page = await translate('xx');
+
+    expect(page.querySelector('button')?.textContent).toBe('Reload');
+  });
+});

package/src/static-page-translations.ts

@@ -0,0 +1,53 @@
+import LanguageDetector from 'i18next-browser-languagedetector';
+import { languageDetectionOptions } from './language-detection';
+
+let translations: Promise<Record<string, string>> | undefined;
+
+/**
+ * Translates the pages the shell renders from `index.ejs` templates, such as the error page. These can
+ * appear before i18next is set up, or because setting it up failed, so the core translations are
+ * loaded directly for the language i18next would detect, without config overrides or interpolation.
+ *
+ * Each element with a `data-i18n` attribute has its text replaced by the core translation of that key
+ * once the translations load. Until then, or if they can't be loaded, the template's English text stays.
+ */
+export function translateStaticPage(root: ParentNode) {
+  const elements = Array.from(root.querySelectorAll<HTMLElement>('[data-i18n]'));
+  if (elements.length === 0) {
+    return;
+  }
+
+  void loadTranslations().then((loaded) => {
+    for (const element of elements) {
+      const translation = loaded[element.dataset.i18n!];
+      if (translation) {
+        element.textContent = translation;
+      }
+    }
+  });
+}
+
+function loadTranslations() {
+  translations ??= (async () => {
+    const detected = new LanguageDetector(undefined, languageDetectionOptions).detect();
+    const language = Array.isArray(detected) ? detected[0] : detected;
+    if (!language) {
+      return {};
+    }
+
+    // Translation files are named with underscores, e.g. `pt_BR.json`.
+    const candidates = new Set([language.replace('-', '_'), language.split(/[-_]/)[0]]);
+    for (const candidate of candidates) {
+      try {
+        const json = await import(/* webpackMode: "lazy" */ `@openmrs/esm-translations/translations/${candidate}.json`);
+        return (json.default ?? json) as Record<string, string>;
+      } catch {
+        // Try the next candidate
+      }
+    }
+
+    return {};
+  })();
+
+  return translations;
+}

package/src/ui/server-starting.component.tsx

@@ -0,0 +1,74 @@
+import React, { useEffect, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { Link, Loading, Tile } from '@carbon/react';
+import {
+  getConfig,
+  getCoreTranslation,
+  interpolateUrl,
+  makeUrl,
+  type StyleguideConfigObject,
+} from '@openmrs/esm-framework/src/internal';
+
+/** How long the server may take to start before the page tells the user it is taking longer than usual. */
+export const slowStartupMillis = 30 * 60 * 1000;
+
+interface ServerStartingPageProps {
+  logo: StyleguideConfigObject['logo'];
+}
+
+export function ServerStartingPage({ logo }: ServerStartingPageProps) {
+  const [isSlow, setIsSlow] = useState(false);
+
+  useEffect(() => {
+    const timer = setTimeout(() => setIsSlow(true), slowStartupMillis);
+    return () => clearTimeout(timer);
+  }, []);
+
+  return (
+    <Tile className="omrs-server-starting__tile">
+      {logo?.src ? (
+        <img className="omrs-server-starting__logo" alt={logo.alt} src={interpolateUrl(logo.src)} />
+      ) : (
+        <svg role="img" className="omrs-server-starting__logo">
+          <title>OpenMRS</title>
+          <use href="#omrs-logo-full-color"></use>
+        </svg>
+      )}
+      <Loading withOverlay={false} description={getCoreTranslation('waitingForServer')} />
+      <div className="omrs-server-starting__text" aria-live="polite">
+        <h1>{getCoreTranslation('serverStartingUp')}</h1>
+        <p>
+          {isSlow
+            ? getCoreTranslation('serverStartingUpSlowExplainer')
+            : getCoreTranslation('serverStartingUpExplainer')}
+        </p>
+      </div>
+      <Link href={makeUrl('/initialsetup')}>{getCoreTranslation('viewSetupProgress')}</Link>
+    </Tile>
+  );
+}
+
+/**
+ * Renders the page shown while the backend is running its initial setup and returns a function that removes it.
+ * It relies on the styleguide config and translations, so it should only be rendered once the app has booted.
+ */
+export function renderServerStartingPage(): () => void {
+  const container = document.createElement('div');
+  container.className = 'omrs-server-starting';
+  document.body.appendChild(container);
+
+  const root = createRoot(container);
+  let removed = false;
+
+  getConfig<StyleguideConfigObject>('@openmrs/esm-styleguide').then(({ logo }) => {
+    if (!removed) {
+      root.render(<ServerStartingPage logo={logo} />);
+    }
+  });
+
+  return () => {
+    removed = true;
+    root.unmount();
+    container.remove();
+  };
+}

package/src/ui/server-starting.test.tsx

@@ -0,0 +1,45 @@
+import React from 'react';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { act, render, screen } from '@testing-library/react';
+
+vi.mock('@openmrs/esm-framework/src/internal', () => ({
+  getConfig: vi.fn(),
+  getCoreTranslation: (key: string) => key,
+  interpolateUrl: (url: string) => url.replace('${openmrsBase}', '/openmrs'),
+  makeUrl: (path: string) => `/openmrs${path}`,
+}));
+
+import { ServerStartingPage, slowStartupMillis } from './server-starting.component';
+
+describe('ServerStartingPage', () => {
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('shows the default logo, a spinner, and a link to the setup page', () => {
+    render(<ServerStartingPage logo={{ src: '', alt: 'Logo' }} />);
+
+    expect(screen.getByRole('img', { name: 'OpenMRS' })).toBeInTheDocument();
+    expect(screen.getByTitle('waitingForServer')).toBeInTheDocument();
+    expect(screen.getByRole('heading', { name: 'serverStartingUp' })).toBeInTheDocument();
+    expect(screen.getByText('serverStartingUpExplainer')).toBeInTheDocument();
+    expect(screen.getByRole('link', { name: 'viewSetupProgress' })).toHaveAttribute('href', '/openmrs/initialsetup');
+  });
+
+  it('shows the configured logo', () => {
+    render(<ServerStartingPage logo={{ src: '${openmrsBase}/brand.png', alt: 'Brand logo' }} />);
+
+    expect(screen.getByAltText('Brand logo')).toHaveAttribute('src', '/openmrs/brand.png');
+  });
+
+  it('says the startup is taking longer than usual once it has been waiting a long time', () => {
+    vi.useFakeTimers();
+    render(<ServerStartingPage logo={{ src: '', alt: 'Logo' }} />);
+
+    act(() => vi.advanceTimersByTime(slowStartupMillis - 1));
+    expect(screen.getByText('serverStartingUpExplainer')).toBeInTheDocument();
+
+    act(() => vi.advanceTimersByTime(1));
+    expect(screen.getByText('serverStartingUpSlowExplainer')).toBeInTheDocument();
+  });
+});

package/vitest.config.ts

@@ -5,6 +5,8 @@ export default defineConfig({
   resolve: {
     alias: {
       '@openmrs/esm-framework/src/internal': resolve(__dirname, '../../framework/esm-emr-api/src/events/index.ts'),
+      // Mirrors the alias in rspack.config.js; the package doesn't export its translation files.
+      '@openmrs/esm-translations/translations': resolve(__dirname, '../../framework/esm-translations/translations'),
     },
   },
   test: {
@@ -15,6 +17,7 @@ export default defineConfig({
       },
     },
     mockReset: true,
+    setupFiles: ['./setup-tests.ts'],
     // `browser-targets.test.ts` builds the real rspack config, which compiles the styleguide stylesheet
     // through sass; on CI that alone can exceed vitest's unit-test-sized default.
     testTimeout: 20_000,

package/dist/05ce2d37a1daa834.js

@@ -1 +0,0 @@
-"use strict";(globalThis.webpackChunk_openmrs_esm_app_shell=globalThis.webpackChunk_openmrs_esm_app_shell||[]).push([["6590"],{7581(e){e.exports=JSON.parse('{"abnormalValue":"Abnormal value","actionableNotification":"Actionable notification","actions":"Actions","address":"Address","address1":"Address line 1","address2":"Address line 2","address3":"Address line 3","address4":"Address line 4","address5":"Address line 5","address6":"Address line 6","age":"Age","batchActionItemSelected":"{{totalSelected}} item selected","batchActionsItemsSelected":"{{totalSelected}} items selected","cancel":"Cancel","change":"Change","city":"City","cityVillage":"City","Clinic":"Clinic","close":"Close","closeAllOpenedWorkspaces":"Discard changes in {{count}} workspaces","closesActionableNotification":"Close actionable notification","closeSnackbar":"Close snackbar","closingAllWorkspacesPromptBody":"There may be unsaved changes in the following workspaces. Do you want to discard changes in the following workspaces? {{workspaceNames}}","closingAllWorkspacesPromptTitle":"You have unsaved changes","confirm":"Confirm","contactAdministratorIfIssuePersists":"Contact your system administrator if the problem persists.","contactDetails":"Contact Details","country":"Country","countyDistrict":"District","delete":"Delete","discard":"Discard","discardChanges":"Discard changes","discardUnsavedChangesPromptBodyMultiple":"{{count}} workspaces have unsaved changes. Closing them will discard the changes:","discardUnsavedChangesPromptBodySingle":"<strong>{{workspaceTitle}}</strong> has unsaved changes. Closing it will discard them.","discardUnsavedChangesPromptTitle":"Discard unsaved changes?","district":"District","edit":"Edit","emptyStateText":"There are no {{displayText}} to display","error":"Error","errorCopy":"Sorry, there was a problem displaying this information. You can try to reload this page, or contact the site administrator and quote the error code above.","errorLoadingLoginLocations":"Unable to load login locations. Please try again or contact support if the problem persists.","female":"Female","hide":"Hide","keepEditing":"Keep editing","leftNavigation":"Left navigation","loading":"Loading","localVersion":"Local Build","male":"Male","maximize":"Maximize","minimize":"Minimize","navigateNonHttp":"Could not navigate to the requested page as it is not a safe URL","noResultsToDisplay":"No results to display","notAvailable":"Not available","openAnyway":"Open Anyway","other":"Other","paginationItemsCount":"{{pageItemsCount}} / {{totalItems}} items","paginationOfPages":"of {{count}} pages","patientAvatarAlt":"Avatar for {{patientName}}","patientIdentifierSticker":"Patient identifier sticker","patientLists":"Patient Lists","patientPhotoAlt":"Profile photo of {{patientName}}","patientPhotoPlaceholder":"Photo placeholder for {{patientName}}","postalCode":"Postal code","prereleaseVersion":"Prerelease","print":"Print","printError":"Print error","printErrorExplainer":"An error occurred in {{errorLocation}}","printIdentifierSticker":"Print identifier sticker","printing":"Printing","recordNewEntry":"Record {{displayText}}","relationships":"Relationships","resetOverrides":"Reset overrides","save":"Save","scriptLoadingError":"Failed to load overridden script from {{url}}. Please check that the bundled script is available at the expected URL. Click the button below to reset all import map overrides.","scriptLoadingFailed":"Error: Script failed to load","searchForLocation":"Search for a location","seeAll":"See all","seeMoreLists":"See {{count}} more lists","selectAll":"Select all","sex":"Sex","showLess":"Show less","showMore":"Show more","snackbarNotification":"Snackbar notification","state":"State","stateProvince":"State","toggleDevTools":"Toggle dev tools","unknown":"Unknown","unsavedChangesInOpenedWorkspace":"You may have unsaved changes in the opened workspace. Do you want to discard these changes?","unsavedChangesInWorkspace":"There may be unsaved changes in \\"{{workspaceName}}\\". Please save them before opening another workspace.","unsavedChangesTitleText":"Unsaved changes","workspaceHeader":"Workspace header","yearAbbreviation":"yr","yearsAbbreviation":"yrs"}')}}]);