[WTF-2710]: Fix unit tests failing on ValueStatus import

packages/pluggable-widgets-tools/CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+### Added
+
+-   We fixed an issue with the Jest configuration affecting unit tests for widgets importing enums from the mendix package (e.g. ValueStatus, FormatterType). It would cause tests to fail with the error "This package should not be used in the runtime".
+
 ## [11.12.0] - 2026-06-30
 
 ### Changed

packages/pluggable-widgets-tools/package.json

@@ -12,7 +12,8 @@
   },
   "scripts": {
     "prepack": "shx rm -rf dist && tsc",
-    "test": "jest"
+    "typecheck:test-config": "tsc -p test-config/tsconfig.json",
+    "test": "pnpm typecheck:test-config && jest"
   },
   "files": [
     "bin",

packages/pluggable-widgets-tools/test-config/__mocks__/mendix.js

@@ -0,0 +1,28 @@
+// @ts-check
+// Runtime mock for the types-only `mendix` package (its real entry throws).
+// Stays plain JS because it ships inside the consumer's node_modules, where
+// jest won't transform TypeScript. The JSDoc `@type` annotations check the
+// values against `mendix`'s types (repo-only, via test-config/tsconfig.json)
+// and are erased at runtime.
+
+/** @typedef {typeof import("mendix")} MendixModule */
+
+/**
+ * Map an enum's type to `{ [Member]: itsStringValue }`.
+ * @template E
+ * @typedef {{ [K in keyof E]: `${Extract<E[K], string>}` }} EnumMock
+ */
+
+module.exports = {
+    /** @type {EnumMock<MendixModule["ValueStatus"]>} */
+    ValueStatus: {
+        Available: "available",
+        Unavailable: "unavailable",
+        Loading: "loading"
+    },
+    /** @type {EnumMock<MendixModule["FormatterType"]>} */
+    FormatterType: {
+        Number: "number",
+        DateTime: "datetime"
+    }
+};

packages/pluggable-widgets-tools/test-config/jest.config.js

@@ -24,6 +24,7 @@ module.exports = {
     },
     moduleNameMapper: {
         "\\.(css|less|scss|sass)$": "identity-obj-proxy",
+        "^mendix$": join(__dirname, "__mocks__/mendix"),
         "mendix/components/web/Icon": join(__dirname, "__mocks__/WebIcon"),
         "mendix/filters/builders": join(__dirname, "__mocks__/FilterBuilders"),
         "\\.png$": join(__dirname, "assetsTransformer.js"),

packages/pluggable-widgets-tools/test-config/tsconfig.json

@@ -0,0 +1,10 @@
+{
+    "extends": "../configs/tsconfig.base",
+    "compilerOptions": {
+        "noEmit": true,
+        "allowJs": true,
+        "checkJs": true,
+        "moduleResolution": "bundler"
+    },
+    "include": ["__mocks__/mendix.js"]
+}