@koech/esm-core 8.0.0

package/e2e/support/github/.dockerignore

@@ -0,0 +1,2 @@
+# .dockerignore
+node_modules

package/e2e/support/github/Dockerfile

@@ -0,0 +1,21 @@
+# syntax=docker/dockerfile:1.3
+FROM --platform=$BUILDPLATFORM node:22-alpine as dev
+
+ARG APP_SHELL_VERSION=next
+
+RUN mkdir -p /app
+WORKDIR /app
+
+COPY . .
+
+ARG CACHE_BUST
+
+RUN yarn install
+RUN node packages/tooling/openmrs/dist/cli.js assemble --manifest --mode config --config spa-assemble-config.json --target /app/spa
+RUN node packages/tooling/openmrs/dist/cli.js build --target /app/spa
+
+FROM --platform=$BUILDPLATFORM openmrs/openmrs-reference-application-3-frontend:nightly as frontend
+# clear out the already installed files
+RUN rm -rf /usr/share/nginx/html/*
+# add our custom build
+COPY --from=dev /app/spa/ /usr/share/nginx/html/

package/e2e/support/github/commit_and_export_images.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+backend_container_id=$(docker ps --filter "name=backend" --format "{{.ID}}")
+db_container_id=$(docker ps --filter "name=db" --format "{{.ID}}")
+frontend_container_id=$(docker ps --filter "name=frontend" --format "{{.ID}}")
+gateway_container_id=$(docker ps --filter "name=gateway" --format "{{.ID}}")
+
+docker commit $frontend_container_id frontend
+docker commit $gateway_container_id gateway
+docker commit $backend_container_id backend
+docker commit $db_container_id db
+
+docker save frontend > e2e_release_env_images.tar
+docker save frontend gateway backend db > e2e_release_env_images.tar
+
+# compress the file (to decrease the upload file size)
+gzip -c e2e_release_env_images.tar > e2e_release_env_images.tar.gz

package/e2e/support/github/docker-compose.yml

@@ -0,0 +1,31 @@
+# This docker compose file is used to create a backend environment for the e2e.yml workflow.
+# The images are pre-filled with data so that the backend environment can be started within a short time.
+version: "3.7"
+
+services:
+  gateway:
+    image: openmrs/openmrs-reference-application-3-gateway:${TAG:-nightly}
+    hostname: gateway
+    depends_on:
+      - frontend
+      - backend
+    ports:
+      - "${E2E_PORT:-8080}:80"
+
+  frontend:
+    build:
+      context: .
+    hostname: frontend
+    environment:
+      SPA_PATH: /openmrs/spa
+      API_URL: /openmrs
+
+  backend:
+    image: openmrs/openmrs-reference-application-3-backend:nightly-with-data
+    hostname: backend
+    depends_on:
+      - db
+
+  db:
+    image: openmrs/openmrs-reference-application-3-db:nightly-with-data
+    hostname: db

package/e2e/support/github/run-e2e-docker-env.sh

@@ -0,0 +1,354 @@
+#!/usr/bin/env bash
+set -eu
+
+# E2E Test Runner for OpenMRS ESM Core
+#
+# Usage:
+#   ./run-e2e-docker-env.sh [options] [-- playwright-args]
+#
+# Options:
+#   --keep-on-failure    Keep Docker containers running if tests fail (for debugging)
+#   --list               Use list reporter (CLI-friendly, no browser popup)
+#
+# Examples:
+#   ./run-e2e-docker-env.sh                      # Run all tests
+#   ./run-e2e-docker-env.sh -- --headed          # Run tests with browser visible
+#   ./run-e2e-docker-env.sh -- login.spec.ts     # Run specific test file
+#   ./run-e2e-docker-env.sh --keep-on-failure    # Keep containers on test failure
+#   ./run-e2e-docker-env.sh --list               # CLI-friendly output (for AI tools)
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+script_dir=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+repository_root="$script_dir/../../../."
+
+# Parse arguments
+keep_on_failure=false
+use_list_reporter=false
+playwright_args=()
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --keep-on-failure)
+      keep_on_failure=true
+      shift
+      ;;
+    --list)
+      use_list_reporter=true
+      shift
+      ;;
+    --)
+      shift
+      playwright_args=("$@")
+      break
+      ;;
+    *)
+      playwright_args+=("$1")
+      shift
+      ;;
+  esac
+done
+
+# ============================================================================
+# Utility Functions
+# ============================================================================
+
+# Find an available port starting from 8080
+find_available_port() {
+  local port=8080
+  while lsof -i:"$port" >/dev/null 2>&1 || nc -z localhost "$port" 2>/dev/null; do
+    port=$((port + 1))
+    if [[ $port -gt 9000 ]]; then
+      echo "ERROR: Could not find available port in range 8080-9000" >&2
+      exit 1
+    fi
+  done
+  echo "$port"
+}
+
+# Generate a unique project name from the git branch
+generate_project_name() {
+  local branch
+  branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "local")
+  # Sanitize: lowercase, replace non-alphanumeric with dash, limit length
+  echo "openmrs-e2e-$(echo "$branch" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | cut -c1-40)"
+}
+
+# Wait for the gateway container to be running
+wait_for_gateway() {
+  local max_attempts=30
+  local attempt=0
+  echo "Waiting for gateway container to start..."
+  while ! docker compose -p "$project_name" -f "$compose_file" ps --status running --services 2>/dev/null | grep -q "^gateway$"; do
+    attempt=$((attempt + 1))
+    if [[ $attempt -ge $max_attempts ]]; then
+      echo "ERROR: Gateway container failed to start within 60 seconds"
+      echo "Container status:"
+      docker compose -p "$project_name" -f "$compose_file" ps
+      echo "Gateway logs:"
+      docker compose -p "$project_name" -f "$compose_file" logs gateway
+      exit 1
+    fi
+    sleep 2
+  done
+  echo "Gateway container is running!"
+}
+
+# Wait for the backend to be ready
+wait_for_backend() {
+  local url="$1"
+  local max_attempts=60
+  local attempt=0
+  echo "Waiting for backend to be ready at $url..."
+  while ! curl -sf "$url/login.htm" >/dev/null 2>&1; do
+    attempt=$((attempt + 1))
+    if [[ $attempt -ge $max_attempts ]]; then
+      echo "ERROR: Backend failed to start within 5 minutes"
+      exit 1
+    fi
+    echo "  Attempt $attempt/$max_attempts - waiting 5 seconds..."
+    sleep 5
+  done
+  echo "Backend is ready!"
+}
+
+# ============================================================================
+# Main Script
+# ============================================================================
+
+# Generate unique identifiers for this run
+project_name=$(generate_project_name)
+export E2E_PORT=$(find_available_port)
+base_url="http://localhost:$E2E_PORT/openmrs"
+
+echo "========================================"
+echo "OpenMRS E2E Test Runner"
+echo "========================================"
+echo "Project name: $project_name"
+echo "Port: $E2E_PORT"
+echo "Base URL: $base_url"
+echo "Keep on failure: $keep_on_failure"
+echo "========================================"
+
+# Create a temporary working directory
+working_dir=$(mktemp -d "${TMPDIR:-/tmp/}openmrs-e2e-frontends.XXXXXXXXXX")
+echo "Working directory: $working_dir"
+
+# Store paths for cleanup
+compose_file="$working_dir/docker-compose.yml"
+
+# ============================================================================
+# Cleanup Handler
+# ============================================================================
+
+test_exit_code=0
+
+cleanup() {
+  local cleanup_exit_code=$test_exit_code
+
+  # If we're in CI mode, don't clean up (CI handles its own cleanup)
+  if [[ "${CI:-}" == "true" || "${GITHUB_ACTIONS:-}" == "true" ]]; then
+    echo "CI environment detected - skipping cleanup"
+    return
+  fi
+
+  # If keep_on_failure is true and tests failed, don't clean up
+  if [[ "$keep_on_failure" == "true" && $cleanup_exit_code -ne 0 ]]; then
+    echo ""
+    echo "========================================"
+    echo "Tests failed. Keeping containers running for debugging."
+    echo "========================================"
+    echo "Base URL: $base_url"
+    echo ""
+    echo "To stop containers manually:"
+    echo "  docker compose -p $project_name -f $compose_file down -v"
+    echo ""
+    echo "To view logs:"
+    echo "  docker compose -p $project_name -f $compose_file logs -f"
+    echo "========================================"
+    return
+  fi
+
+  echo ""
+  echo "Stopping Docker containers..."
+  docker compose -p "$project_name" -f "$compose_file" down -v 2>/dev/null || true
+  echo "Cleanup complete."
+}
+
+# Set up trap for cleanup on exit, interrupt, or termination
+trap cleanup EXIT
+
+# ============================================================================
+# Build Frontend
+# ============================================================================
+
+# Get a list of all the apps in this workspace
+apps=$(yarn workspaces list --json | jq -r 'if .location | test("-app$") then .name else empty end')
+# This array will hold all of the packed app names
+app_names=()
+
+echo ""
+echo "Creating packed archives of apps..."
+# For each app
+for app in $apps
+do
+  # @openmrs/esm-whatever -> _openmrs_esm_whatever
+  app_name=$(echo "$app" | tr '[:punct:]' '_');
+  # Add to our array
+  app_names+=("$app_name.tgz");
+  # Run yarn pack for our app and add it to the working directory
+  yarn workspace "$app" pack -o "$working_dir/$app_name.tgz" >/dev/null;
+done;
+echo "Created packed app archives"
+
+echo "Creating dynamic spa-assemble-config.json..."
+# Dynamically assemble our list of frontend modules, prepending the
+# required apps; apps will all be in the /app directory of the Docker
+# container
+jq -n \
+  --arg apps "$apps" \
+  --arg app_names "$(echo ${app_names[@]})" \
+  '{
+    "@openmrs/esm-active-visits-app": "next",
+    "@openmrs/esm-appointments-app": "next",
+    "@openmrs/esm-bed-management-app": "next",
+    "@openmrs/esm-cohort-builder-app": "next",
+    "@openmrs/esm-dispensing-app": "next",
+    "@openmrs/esm-fast-data-entry-app": "next",
+    "@openmrs/esm-form-builder-app": "next",
+    "@openmrs/esm-form-engine-app": "next",
+    "@openmrs/esm-generic-patient-widgets-app": "next",
+    "@openmrs/esm-home-app": "next",
+    "@openmrs/esm-laboratory-app": "next",
+    "@openmrs/esm-openconceptlab-app": "next",
+    "@openmrs/esm-patient-allergies-app": "next",
+    "@openmrs/esm-patient-attachments-app": "next",
+    "@openmrs/esm-patient-banner-app": "next",
+    "@openmrs/esm-patient-chart-app": "next",
+    "@openmrs/esm-patient-conditions-app": "next",
+    "@openmrs/esm-patient-flags-app": "next",
+    "@openmrs/esm-patient-forms-app": "next",
+    "@openmrs/esm-patient-immunizations-app": "next",
+    "@openmrs/esm-patient-list-management-app": "next",
+    "@openmrs/esm-patient-lists-app": "next",
+    "@openmrs/esm-patient-medications-app": "next",
+    "@openmrs/esm-patient-notes-app": "next",
+    "@openmrs/esm-patient-orders-app": "next",
+    "@openmrs/esm-patient-programs-app": "next",
+    "@openmrs/esm-patient-registration-app": "next",
+    "@openmrs/esm-patient-search-app": "next",
+    "@openmrs/esm-patient-tests-app": "next",
+    "@openmrs/esm-patient-vitals-app": "next",
+    "@openmrs/esm-service-queues-app": "next",
+    "@openmrs/esm-system-admin-app": "next",
+    "@openmrs/esm-user-onboarding-app": "next",
+    "@openmrs/esm-ward-app": "next",
+    "@openmrs/esm-stock-management-app": "next",
+    "@openmrs/esm-billing-app": "next"
+  } + (
+    ($apps | split("\n")) as $apps | ($app_names | split(" ") | map("/app/" + .)) as $app_files
+    | [$apps, $app_files]
+    | transpose
+    | map({"key": .[0], "value": .[1]})
+    | from_entries
+  )' | jq '{"frontendModules": .}' > "$working_dir/spa-assemble-config.json"
+
+echo "Created dynamic spa-assemble-config.json"
+
+echo "Copying tooling, shell and framework..."
+mkdir -p "$working_dir/packages"
+mkdir -p "$working_dir/packages/tooling"
+
+cp -r "$repository_root/.yarn" "$working_dir/.yarn"
+cp -r "$repository_root/.yarnrc.yml" "$working_dir/.yarnrc.yml"
+cp -r "$repository_root/packages/tooling" "$working_dir/packages"
+cp -r "$repository_root/packages/shell" "$working_dir/packages"
+cp -r "$repository_root/packages/framework" "$working_dir/packages"
+cp "$repository_root/package.json" "$working_dir/package.json"
+cp "$repository_root/yarn.lock" "$working_dir/yarn.lock"
+
+echo "Copying Docker configuration..."
+cp "$script_dir/Dockerfile" "$working_dir/Dockerfile"
+cp "$script_dir/.dockerignore" "$working_dir/.dockerignore"
+cp "$script_dir/docker-compose.yml" "$working_dir/docker-compose.yml"
+
+# ============================================================================
+# Start Docker Containers
+# ============================================================================
+
+cd "$working_dir"
+echo ""
+echo "Building and starting Docker containers..."
+# CACHE_BUST to ensure the assemble step is always run
+docker compose -p "$project_name" build --build-arg CACHE_BUST=$(date +%s) frontend
+docker compose -p "$project_name" up -d
+
+# ============================================================================
+# Wait for backend to be ready
+# ============================================================================
+
+# Wait for gateway container to be running before starting the backend timeout
+wait_for_gateway
+
+# Wait for backend to be ready
+wait_for_backend "$base_url"
+
+# ============================================================================
+# CI Mode: Exit here, let CI handle tests separately
+# ============================================================================
+
+if [[ "${CI:-}" == "true" || "${GITHUB_ACTIONS:-}" == "true" ]]; then
+  echo ""
+  echo "CI environment detected - backend ready, exiting for CI to run tests"
+  echo "Base URL: $base_url"
+  # Export environment variables for GitHub Actions
+  if [[ -n "${GITHUB_ENV:-}" ]]; then
+    echo "E2E_BASE_URL=$base_url" >> "$GITHUB_ENV"
+    echo "E2E_PORT=$E2E_PORT" >> "$GITHUB_ENV"
+  fi
+  exit 0
+fi
+
+# ============================================================================
+# Local Mode: Run tests
+# ============================================================================
+
+# Copy environment variables if .env doesn't exist
+cd "$repository_root"
+if [[ ! -f .env ]]; then
+  echo "Copying example.env to .env..."
+  cp example.env .env
+fi
+
+echo ""
+echo "========================================"
+echo "Running Playwright tests..."
+echo "========================================"
+
+# Build environment variables for test run
+test_env="E2E_BASE_URL=$base_url"
+if [[ "$use_list_reporter" == "true" ]]; then
+  test_env="$test_env E2E_REPORTER=list"
+fi
+
+# Run tests with the correct base URL
+set +e  # Don't exit on test failure
+env $test_env yarn playwright test ${playwright_args[@]+"${playwright_args[@]}"}
+test_exit_code=$?
+set -e
+
+if [[ $test_exit_code -eq 0 ]]; then
+  echo ""
+  echo "========================================"
+  echo "All tests passed!"
+  echo "========================================"
+else
+  echo ""
+  echo "========================================"
+  echo "Tests failed with exit code: $test_exit_code"
+  echo "========================================"
+fi
+
+# Exit with the test exit code (cleanup will run via trap)
+exit $test_exit_code

package/example.env

@@ -0,0 +1,6 @@
+# This is an example environment file for configuring dynamic values.
+E2E_BASE_URL=http://localhost:8080/openmrs
+E2E_USER_ADMIN_USERNAME=admin
+E2E_USER_ADMIN_PASSWORD=Admin123
+E2E_LOGIN_DEFAULT_LOCATION_UUID=44c3efb0-2583-4c80-a79e-1f756a03c0a1
+# The above location UUID is for the "Outpatient Clinic" location in the reference application

package/markdown_link_check_config.json

@@ -0,0 +1,24 @@
+{
+  "httpHeaders": [
+    {
+      "urls": ["https://docs.github.com/"],
+      "headers": {
+        "Accept-Encoding": "zstd, br, gzip, deflate"
+      }
+    }
+  ],
+  "ignorePatterns": [
+    {
+      "pattern": "^https://dev3.openmrs.org"
+    },
+    {
+      "pattern": "^https://www.npmjs.com/package/@openmrs/"
+    },
+    {
+      "pattern": "^http://localhost"
+    }
+  ],
+  "retryOn429": true,
+  "retryCount": 3,
+  "retryDelay": 1000
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@koech/esm-core",
+  "version": "8.0.0",
+  "private": false,
+  "workspaces": [
+    "packages/apps/*",
+    "packages/framework/*",
+    "packages/shell/*",
+    "packages/tooling/*"
+  ],
+  "scripts": {
+    "run:omrs": "openmrs",
+    "run:shell": "yarn workspace @openmrs/esm-app-shell watch",
+    "ci:publish-next": "yarn workspaces foreach --all --topological --exclude @openmrs/esm-core npm publish --tolerate-republish --access public --tag next",
+    "ci:publish": "yarn workspaces foreach --all --topological --exclude @openmrs/esm-core npm publish --tolerate-republish --access public --tag latest",
+    "release": "yarn workspaces foreach --all --topological version",
+    "build": "turbo run build",
+    "build:apps": "turbo run build --filter='@openmrs/*-app'",
+    "setup": "yarn install && turbo run build",
+    "start": "openmrs develop",
+    "dev": "openmrs develop --sources=packages/apps/esm-login-app --backend=https://staging.ampath.or.ke --api-url=/openmrs --config-url=https://ngx.ampath.or.ke/o3-config.json --port=9000",
+    "verify": "turbo run lint test typescript",
+    "postinstall": "husky install",
+    "test": "turbo run test",
+    "test-e2e": "./e2e/support/github/run-e2e-docker-env.sh",
+    "coverage": "turbo run test --coverage"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.1",
+    "@swc/core": "^1.11.29",
+    "@swc/jest": "^0.2.38",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.3.21",
+    "@types/react-dom": "^18.3.0",
+    "@types/webpack-env": "^1.16.4",
+    "@typescript-eslint/eslint-plugin": "^8.35.0",
+    "@typescript-eslint/parser": "^8.35.0",
+    "classnames": "^2.3.2",
+    "cross-env": "^7.0.3",
+    "dotenv": "^16.0.3",
+    "eslint": "^8.55.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jest-dom": "^5.5.0",
+    "eslint-plugin-playwright": "^2.1.0",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "eslint-plugin-testing-library": "^7.1.1",
+    "fake-indexeddb": "^4.0.2",
+    "fork-ts-checker-webpack-plugin": "^7.2.13",
+    "husky": "^8.0.3",
+    "i18next-parser": "^9.3.0",
+    "identity-obj-proxy": "^3.0.0",
+    "jest": "^29.7.0",
+    "jest-cli": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "lint-staged": "^15.2.9",
+    "openmrs": "workspace:*",
+    "prettier": "^3.1.0",
+    "swc-loader": "^0.2.6",
+    "timezone-mock": "^1.2.2",
+    "turbo": "^2.5.2",
+    "typescript": "^5.8.3",
+    "webpack": "^5.99.9"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": "eslint --cache --fix --max-warnings 0",
+    "*.{css,scss,ts,tsx}": "prettier --write --list-different"
+  },
+  "packageManager": "yarn@4.10.3"
+}

package/packages/apps/esm-devtools-app/README.md

@@ -0,0 +1,37 @@
+# openmrs-esm-devtools
+
+openmrs-esm-devtools is an in-browser javascript module that provides a UI for developers writing frontend code.
+
+![esm-devtools](https://user-images.githubusercontent.com/1031876/81030238-f5b9d500-8e3c-11ea-81b8-6c2a4938faf2.gif)
+
+## Purpose
+
+The devtools allow you to override any javascript module to point to any url.
+This is useful for developing features and for debugging problems, because you
+can tell the browser to load one module from your localhost while keeping all
+other modules using the default version in the import map.
+
+## Installation / Usage
+
+The devtools are registered as a
+[single-spa application](https://single-spa.js.org/docs/building-applications/)
+that creates a gray or red rectangular button near the bottom right of the
+screen. The rectangular button will only show up if you run the following
+command in the browser console:
+
+```js
+localStorage.setItem('openmrs:devtools', true)
+```
+
+Now refresh the page and you'll see the rectangle. Note that when the rectangle is
+red that it means that you have an active override.
+
+## Implementation notes
+
+openmrs-esm-devtools is using
+[import-map-overrides](https://github.com/single-spa/import-map-overrides)
+to accomplish this behavior.
+
+## Usage
+
+If you prefer using the browser console instead of a UI to manage module overrides, check out the documentation in that github project.

package/packages/apps/esm-devtools-app/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@openmrs/esm-devtools-app",
+  "version": "8.0.0",
+  "license": "MPL-2.0",
+  "description": "Dev tools for frontend devs using OpenMRS",
+  "browser": "dist/openmrs-esm-devtools-app.js",
+  "main": "src/index.ts",
+  "source": true,
+  "scripts": {
+    "start": "openmrs develop",
+    "serve": "webpack serve --mode=development",
+    "debug": "npm run serve",
+    "test": "cross-env TZ=UTC vitest run --passWithNoTests",
+    "test:watch": "cross-env TZ=UTC vitest watch",
+    "coverage": "cross-env TZ=UTC vitest run --coverage --passWithNoTests",
+    "build": "webpack --mode=production",
+    "build:development": "webpack --mode=development",
+    "analyze": "webpack --mode=production --env analyze=true",
+    "typescript": "tsc",
+    "lint": "eslint src --ext ts,tsx",
+    "extract-translations": "i18next 'src/**/*.tsx' --config='../../../tools/i18next-parser.config.js'"
+  },
+  "keywords": [
+    "openmrs",
+    "microfrontends"
+  ],
+  "browserslist": [
+    "extends browserslist-config-openmrs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openmrs/openmrs-esm-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/openmrs/openmrs-esm-core/issues"
+  },
+  "homepage": "https://github.com/openmrs/openmrs-esm-core#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@carbon/react": "1.x",
+    "@openmrs/esm-framework": "*",
+    "react": "18.x",
+    "react-dom": "18.x",
+    "react-i18next": "16.x",
+    "rxjs": "6.x"
+  },
+  "devDependencies": {
+    "@openmrs/esm-framework": "workspace:*",
+    "@openmrs/webpack-config": "workspace:*",
+    "@vitest/coverage-v8": "^4.0.7",
+    "cross-env": "^7.0.3",
+    "happy-dom": "^17.4.7",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "^16.0.0",
+    "vitest": "^4.0.7",
+    "webpack": "^5.99.9"
+  },
+  "dependencies": {
+    "@carbon/react": "^1.92.1",
+    "fuzzy": "^0.1.3"
+  }
+}

package/packages/apps/esm-devtools-app/setup-tests.ts

@@ -0,0 +1,8 @@
+import { afterEach, vi } from 'vitest';
+import { cleanup } from '@testing-library/react';
+
+(window as any).importMapOverrides = {
+  getOverrideMap: vi.fn().mockReturnValue({ imports: {} }),
+};
+
+afterEach(cleanup);

package/packages/apps/esm-devtools-app/src/declarations.d.ts

@@ -0,0 +1,2 @@
+declare module '*.css';
+declare module '*.scss';

package/packages/apps/esm-devtools-app/src/devtools/devtools-popup.component.tsx

@@ -0,0 +1,25 @@
+import React from 'react';
+import { IconButton } from '@carbon/react';
+import { CloseIcon, getCoreTranslation } from '@openmrs/esm-framework';
+import ImportMap from './import-map.component';
+import styles from './devtools-popup.styles.scss';
+
+type DevToolsPopupProps = {
+  close(): void;
+  toggleOverridden(isOverridden: boolean): void;
+};
+
+function DevToolsPopup(props: DevToolsPopupProps) {
+  return (
+    <div className={styles.popup}>
+      <ImportMap toggleOverridden={props.toggleOverridden} />
+      <div className={styles.farRight}>
+        <IconButton kind="ghost" label={getCoreTranslation('close')} onClick={props.close} size="sm">
+          <CloseIcon size={16} />
+        </IconButton>
+      </div>
+    </div>
+  );
+}
+
+export default DevToolsPopup;