@mui/internal-test-utils 2.0.15 → 2.0.16

package/index.js

@@ -0,0 +1,139 @@
+/**
+ * @mui/internal-test-utils v2.0.16
+ *
+ * @license undefined
+ * This source code is licensed under the undefined license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  strictModeDoubleLoggingSuppressed: true,
+  describeConformance: true,
+  createDescribe: true,
+  focusVisible: true,
+  simulatePointerDevice: true,
+  simulateKeyboardDevice: true,
+  programmaticFocusTriggersFocusVisible: true,
+  fireDiscreteEvent: true,
+  flushMicrotasks: true,
+  reactMajor: true
+};
+Object.defineProperty(exports, "createDescribe", {
+  enumerable: true,
+  get: function () {
+    return _createDescribe.default;
+  }
+});
+Object.defineProperty(exports, "describeConformance", {
+  enumerable: true,
+  get: function () {
+    return _describeConformance.default;
+  }
+});
+exports.fireDiscreteEvent = void 0;
+Object.defineProperty(exports, "flushMicrotasks", {
+  enumerable: true,
+  get: function () {
+    return _flushMicrotasks.default;
+  }
+});
+Object.defineProperty(exports, "focusVisible", {
+  enumerable: true,
+  get: function () {
+    return _focusVisible.default;
+  }
+});
+Object.defineProperty(exports, "programmaticFocusTriggersFocusVisible", {
+  enumerable: true,
+  get: function () {
+    return _focusVisible.programmaticFocusTriggersFocusVisible;
+  }
+});
+Object.defineProperty(exports, "reactMajor", {
+  enumerable: true,
+  get: function () {
+    return _reactMajor.default;
+  }
+});
+Object.defineProperty(exports, "simulateKeyboardDevice", {
+  enumerable: true,
+  get: function () {
+    return _focusVisible.simulateKeyboardDevice;
+  }
+});
+Object.defineProperty(exports, "simulatePointerDevice", {
+  enumerable: true,
+  get: function () {
+    return _focusVisible.simulatePointerDevice;
+  }
+});
+exports.strictModeDoubleLoggingSuppressed = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _components = require("./components");
+Object.keys(_components).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _components[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _components[key];
+    }
+  });
+});
+var _describeConformance = _interopRequireWildcard(require("./describeConformance"));
+Object.keys(_describeConformance).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _describeConformance[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _describeConformance[key];
+    }
+  });
+});
+var _createDescribe = _interopRequireDefault(require("./createDescribe"));
+var _createRenderer = require("./createRenderer");
+Object.keys(_createRenderer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _createRenderer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _createRenderer[key];
+    }
+  });
+});
+var _focusVisible = _interopRequireWildcard(require("./focusVisible"));
+require("./initMatchers");
+var _fireDiscreteEvent = _interopRequireWildcard(require("./fireDiscreteEvent"));
+exports.fireDiscreteEvent = _fireDiscreteEvent;
+var _flushMicrotasks = _interopRequireDefault(require("./flushMicrotasks"));
+var _reactMajor = _interopRequireDefault(require("./reactMajor"));
+var _env = require("./env");
+Object.keys(_env).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _env[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _env[key];
+    }
+  });
+});
+/**
+ * Set to true if console logs during [lifecycles that are invoked twice in `React.StrictMode`](https://reactjs.org/docs/strict-mode.html#detecting-unexpected-side-effects) are suppressed.
+ * Useful for asserting on `console.warn` or `console.error` via `toErrorDev()`.
+ * TODO: Refactor to use reactMajor when fixing the React 17 cron test.
+ * https://github.com/mui/material-ui/issues/43153
+ */
+const strictModeDoubleLoggingSuppressed = exports.strictModeDoubleLoggingSuppressed = React.version.startsWith('17');

package/init.d.ts

@@ -0,0 +1 @@
+export {};

package/init.js

@@ -0,0 +1,15 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var testingLibrary = _interopRequireWildcard(require("@testing-library/react/pure"));
+require("./initMatchers");
+// checking if an element is hidden is quite expensive
+// this is only done in CI as a fail safe. It can still explicitly be checked
+// in the test files which helps documenting what is part of the DOM but hidden
+// from assistive technology
+const defaultHidden = !process.env.CI;
+// adds verbosity for something that might be confusing
+console.warn(`${defaultHidden ? 'including' : 'excluding'} inaccessible elements by default`);
+testingLibrary.configure({
+  defaultHidden
+});

package/initMatchers.d.ts

@@ -0,0 +1 @@
+import "./chai.types.js";

package/initMatchers.js

@@ -0,0 +1,10 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var chai = _interopRequireWildcard(require("chai"));
+var _chaiDom = _interopRequireDefault(require("chai-dom"));
+require("./chai.types");
+var _chaiPlugin = _interopRequireDefault(require("./chaiPlugin"));
+chai.use(_chaiDom.default);
+chai.use(_chaiPlugin.default);

package/initMatchers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/initPlaywrightMatchers.d.ts

@@ -0,0 +1,24 @@
+import * as DomTestingLibrary from '@testing-library/dom';
+declare global {
+  namespace Chai {
+    interface Assertion {
+      /**
+       * Checks if the element handle is actually focused i.e. the element handle is pointing to `document.activeElement`.
+       */
+      toHaveFocus(): Promise<void>;
+      /**
+       * Checks if the element handle has the given attribute.
+       * @example expect($element).toHaveAttribute('aria-expanded') is like `[aria-expanded]` CSS selector
+       * @example expect($element).toHaveAttribute('aria-expanded', 'true') is like `[aria-expanded="true"]` CSS selector
+       */
+      toHaveAttribute(attributeName: string, attributeValue?: string): Promise<void>;
+    }
+  }
+  interface Window {
+    DomTestingLibrary: typeof DomTestingLibrary;
+    /**
+     * @example $element.evaluate(element => window.pageElementToString(element))
+     */
+    elementToString(element: Node | null | undefined): string | false;
+  }
+}

package/initPlaywrightMatchers.js

@@ -0,0 +1,42 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var chai = _interopRequireWildcard(require("chai"));
+var _assertionError = require("assertion-error");
+// https://stackoverflow.com/a/46755166/3406963
+
+chai.use((chaiAPI, utils) => {
+  chai.Assertion.addMethod('toHaveFocus', async function elementHandleIsFocused() {
+    const $elementOrHandle = utils.flag(this, 'object');
+    if ($elementOrHandle == null) {
+      throw new _assertionError.AssertionError(`Expected an element handle but got ${String($elementOrHandle)}.`);
+    }
+    const $element = typeof $elementOrHandle.then === 'function' ? await $elementOrHandle : $elementOrHandle;
+    const {
+      isFocused,
+      stringifiedActiveElement,
+      stringifiedElement
+    } = await $element.evaluate(element => {
+      const activeElement = element.ownerDocument !== null ? element.ownerDocument.activeElement : null;
+      return {
+        isFocused: activeElement === element,
+        stringifiedElement: window.elementToString(element),
+        stringifiedActiveElement: window.elementToString(activeElement)
+      };
+    });
+    this.assert(isFocused, `expected element to have focus`, `expected element to NOT have focus \n${stringifiedElement}`, stringifiedElement, stringifiedActiveElement);
+  });
+  chai.Assertion.addMethod('toHaveAttribute', async function elementHandleHasAttribute(attributeName, attributeValue) {
+    const $elementOrHandle = utils.flag(this, 'object');
+    if ($elementOrHandle == null) {
+      throw new _assertionError.AssertionError(`Expected an element handle but got ${String($elementOrHandle)}.`);
+    }
+    const $element = typeof $elementOrHandle.then === 'function' ? await $elementOrHandle : $elementOrHandle;
+    const actualAttributeValue = await $element.getAttribute(attributeName);
+    if (attributeValue === undefined) {
+      this.assert(actualAttributeValue !== null, `expected element to have attribute \`${attributeName}\``, `expected element to NOT have attribute \`${attributeName}\``, null, null);
+    } else {
+      this.assert(actualAttributeValue === attributeValue, `expected element to have attribute \`${attributeName}="${attributeValue}"\``, `expected element to NOT have attribute \`${attributeName}="${attributeValue}"\``, attributeValue, actualAttributeValue);
+    }
+  });
+});

package/package.json

@@ -1,66 +1,29 @@
 {
   "name": "@mui/internal-test-utils",
-  "version": "2.0.15",
+  "version": "2.0.16",
   "author": "MUI Team",
   "description": "Utilities for MUI tests. This is an internal package not meant for general use.",
-  "main": "./build/index.js",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mui/material-ui.git",
     "directory": "packages-internal/test-utils"
   },
-  "exports": {
-    ".": "./build/index.js",
-    "./createDescribe": "./build/createDescribe.js",
-    "./createRenderer": "./build/createRenderer.js",
-    "./init": "./build/init.js",
-    "./initMatchers": {
-      "types": "./build/initMatchers.d.ts",
-      "default": "./build/initMatchers.js"
-    },
-    "./initPlaywrightMatchers": {
-      "types": "./build/initPlaywrightMatchers.d.ts",
-      "default": "./build/initPlaywrightMatchers.js"
-    },
-    "./KarmaReporterReactProfiler": "./build/KarmaReporterReactProfiler.js",
-    "./setupBabel": "./build/setupBabel.js",
-    "./setupBabelPlaywright": "./build/setupBabelPlaywright.js",
-    "./setupJSDOM": "./build/setupJSDOM.js",
-    "./setupKarma": "./build/setupKarma.js",
-    "./chaiPlugin": "./build/chaiPlugin.js",
-    "./setupVitest": "./build/setupVitest.js",
-    "./describeSkipIf": "./build/describeSkipIf.js"
-  },
   "dependencies": {
-    "@babel/plugin-transform-modules-commonjs": "^7.27.1",
-    "@babel/preset-typescript": "^7.27.1",
-    "@babel/register": "^7.28.3",
     "@babel/runtime": "^7.28.4",
     "@emotion/cache": "^11.14.0",
     "@emotion/react": "^11.14.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
+    "assertion-error": "^2.0.1",
     "chai-dom": "^1.12.1",
     "dom-accessibility-api": "^0.7.0",
-    "es-toolkit": "^1.40.0",
+    "es-toolkit": "^1.41.0",
     "format-util": "^1.0.5",
     "jsdom": "^26.1.0",
-    "mocha": "^11.7.4",
     "prop-types": "^15.8.1",
     "sinon": "^21.0.0"
   },
-  "devDependencies": {
-    "@playwright/test": "^1.56.1",
-    "@types/chai": "^4.3.20",
-    "@types/chai-dom": "^1.11.3",
-    "@types/format-util": "^1.0.4",
-    "@types/prop-types": "^15.7.15",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
-    "@types/sinon": "^17.0.4",
-    "typescript": "^5.9.2"
-  },
   "peerDependencies": {
     "@playwright/test": "^1.53.1",
     "chai": "^4.5.0 || ^5.0.0 || ^6.0.0",
@@ -70,11 +33,91 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "prebuild": "rimraf ./build",
-    "build": "tsc -p tsconfig.build.json",
-    "typescript": "tsc -p tsconfig.json",
-    "release:publish": "pnpm publish --tag latest",
-    "release:publish:dry-run": "pnpm publish --tag latest --registry=\"http://localhost:4873/\""
+  "type": "commonjs",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "default": {
+        "types": "./esm/index.d.ts",
+        "default": "./esm/index.js"
+      }
+    },
+    "./createDescribe": {
+      "require": {
+        "types": "./createDescribe.d.ts",
+        "default": "./createDescribe.js"
+      },
+      "default": {
+        "types": "./esm/createDescribe.d.ts",
+        "default": "./esm/createDescribe.js"
+      }
+    },
+    "./createRenderer": {
+      "require": {
+        "types": "./createRenderer.d.ts",
+        "default": "./createRenderer.js"
+      },
+      "default": {
+        "types": "./esm/createRenderer.d.ts",
+        "default": "./esm/createRenderer.js"
+      }
+    },
+    "./init": {
+      "require": {
+        "types": "./init.d.ts",
+        "default": "./init.js"
+      },
+      "default": {
+        "types": "./esm/init.d.ts",
+        "default": "./esm/init.js"
+      }
+    },
+    "./initMatchers": {
+      "require": {
+        "types": "./initMatchers.d.ts",
+        "default": "./initMatchers.js"
+      },
+      "default": {
+        "types": "./esm/initMatchers.d.ts",
+        "default": "./esm/initMatchers.js"
+      }
+    },
+    "./initPlaywrightMatchers": {
+      "require": {
+        "types": "./initPlaywrightMatchers.d.ts",
+        "default": "./initPlaywrightMatchers.js"
+      },
+      "default": {
+        "types": "./esm/initPlaywrightMatchers.d.ts",
+        "default": "./esm/initPlaywrightMatchers.js"
+      }
+    },
+    "./chaiPlugin": {
+      "require": {
+        "types": "./chaiPlugin.d.ts",
+        "default": "./chaiPlugin.js"
+      },
+      "default": {
+        "types": "./esm/chaiPlugin.d.ts",
+        "default": "./esm/chaiPlugin.js"
+      }
+    },
+    "./setupVitest": {
+      "require": {
+        "types": "./setupVitest.d.ts",
+        "default": "./setupVitest.js"
+      },
+      "default": {
+        "types": "./esm/setupVitest.d.ts",
+        "default": "./esm/setupVitest.js"
+      }
+    },
+    "./esm": null
   }
 }

package/reactMajor.d.ts

@@ -0,0 +1,2 @@
+declare const _default: number;
+export default _default;

package/reactMajor.js

@@ -0,0 +1,9 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _default = exports.default = parseInt(React.version, 10);

package/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/setup.js

@@ -0,0 +1,10 @@
+"use strict";
+
+const testingLibrary = require('@testing-library/dom');
+const createDOM = require('./createDOM');
+createDOM();
+require('./init');
+testingLibrary.configure({
+  // JSDOM logs errors otherwise on `getComputedStyle(element, pseudoElement)` calls.
+  computedStyleSupportsPseudoElements: false
+});

package/setupVitest.d.ts

@@ -0,0 +1 @@
+import "./chai.types.js";

package/setupVitest.js

@@ -0,0 +1,32 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _vitestFailOnConsole = _interopRequireDefault(require("vitest-fail-on-console"));
+var chai = _interopRequireWildcard(require("chai"));
+require("./chai.types");
+var _chaiPlugin = _interopRequireDefault(require("./chaiPlugin"));
+chai.use(_chaiPlugin.default);
+(0, _vitestFailOnConsole.default)({
+  silenceMessage: message => {
+    if (process.env.NODE_ENV === 'production') {
+      // TODO: mock scheduler
+      if (message.includes('act(...) is not supported in production builds of React')) {
+        return true;
+      }
+    }
+    if (message.includes('Warning: useLayoutEffect does nothing on the server')) {
+      // Controversial warning that is commonly ignored by switching to `useEffect` on the server.
+      // https://github.com/facebook/react/issues/14927
+      // However, this switch doesn't work since it relies on environment sniffing and we test SSR in a browser environment.
+      return true;
+    }
+
+    // Unclear why this is an issue for the current occurrences of this warning.
+    // TODO: Revisit once https://github.com/facebook/react/issues/22796 is resolved
+    if (message.includes('Detected multiple renderers concurrently rendering the same context provider.')) {
+      return true;
+    }
+    return false;
+  }
+});

package/setupVitestBrowser.d.ts

@@ -0,0 +1 @@
+export {};

package/setupVitestBrowser.js

@@ -0,0 +1,34 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var chai = _interopRequireWildcard(require("chai"));
+var _chaiDom = _interopRequireDefault(require("chai-dom"));
+chai.use(_chaiDom.default);
+
+// Enable missing act warnings: https://github.com/reactwg/react-18/discussions/102
+globalThis.jest = null;
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+if (window.navigator.userAgent.includes('jsdom')) {
+  // Not yet supported: https://github.com/jsdom/jsdom/issues/2152
+  globalThis.window.Touch = class Touch {
+    constructor(instance) {
+      this.instance = instance;
+    }
+    get identifier() {
+      return this.instance.identifier;
+    }
+    get pageX() {
+      return this.instance.pageX;
+    }
+    get pageY() {
+      return this.instance.pageY;
+    }
+    get clientX() {
+      return this.instance.clientX;
+    }
+    get clientY() {
+      return this.instance.clientY;
+    }
+  };
+}