@mui/internal-test-utils 2.0.16 → 2.0.18-canary.1

package/esm/env.js

@@ -1,5 +1,13 @@
-/* eslint-disable import/prefer-default-export */
-
+import * as React from 'react';
 export function isJsdom() {
   return window.navigator.userAgent.includes('jsdom');
-}
+}
+export const reactMajor = parseInt(React.version, 10);
+
+/**
+ * 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
+ */
+export const strictModeDoubleLoggingSuppressed = reactMajor === 17;

package/esm/flushMicrotasks.d.ts

@@ -1 +1 @@
-export default function flushMicrotasks(): Promise<void>;
+export declare function flushMicrotasks(): Promise<void>;

package/esm/flushMicrotasks.js

@@ -1,4 +1,4 @@
 import { act } from "./createRenderer.js";
-export default async function flushMicrotasks() {
+export async function flushMicrotasks() {
   await act(async () => {});
 }

package/esm/index.d.ts

@@ -1,18 +1,10 @@
+import "./initMatchers.js";
 export * from "./components.js";
 export { default as describeConformance } from "./describeConformance.js";
 export * from "./describeConformance.js";
 export { default as createDescribe } from "./createDescribe.js";
 export * from "./createRenderer.js";
 export { default as focusVisible, simulatePointerDevice, simulateKeyboardDevice, programmaticFocusTriggersFocusVisible } from "./focusVisible.js";
-export {} from "./initMatchers.js";
-export * as fireDiscreteEvent from "./fireDiscreteEvent.js";
-export { default as flushMicrotasks } from "./flushMicrotasks.js";
-export { default as reactMajor } from "./reactMajor.js";
-export * from "./env.js";
-/**
- * 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
- */
-export declare const strictModeDoubleLoggingSuppressed: boolean;
+export { fireEvent as fireDiscreteEvent } from '@testing-library/react/pure.js';
+export { flushMicrotasks } from "./flushMicrotasks.js";
+export * from "./env.js";

package/esm/index.js

@@ -1,27 +1,18 @@
 /**
- * @mui/internal-test-utils v2.0.16
+ * @mui/internal-test-utils v2.0.17
  *
  * @license undefined
  * This source code is licensed under the undefined license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import * as React from 'react';
+import "./initMatchers.js";
 export * from "./components.js";
 export { default as describeConformance } from "./describeConformance.js";
 export * from "./describeConformance.js";
 export { default as createDescribe } from "./createDescribe.js";
 export * from "./createRenderer.js";
 export { default as focusVisible, simulatePointerDevice, simulateKeyboardDevice, programmaticFocusTriggersFocusVisible } from "./focusVisible.js";
-export {} from "./initMatchers.js";
-export * as fireDiscreteEvent from "./fireDiscreteEvent.js";
-export { default as flushMicrotasks } from "./flushMicrotasks.js";
-export { default as reactMajor } from "./reactMajor.js";
-export * from "./env.js";
-
-/**
- * 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
- */
-export const strictModeDoubleLoggingSuppressed = React.version.startsWith('17');
+// eslint-disable-next-line import/extensions
+export { fireEvent as fireDiscreteEvent } from '@testing-library/react/pure.js';
+export { flushMicrotasks } from "./flushMicrotasks.js";
+export * from "./env.js";

package/esm/initMatchers.d.ts

@@ -1 +1,5 @@
-import "./chai.types.js";
+import * as chai from 'chai';
+import chaiDom from 'chai-dom';
+import "./chaiTypes.js";
+import chaiPlugin from "./chaiPlugin.js";
+export { chai, chaiDom, chaiPlugin };

package/esm/initMatchers.js

@@ -1,6 +1,9 @@
 import * as chai from 'chai';
 import chaiDom from 'chai-dom';
-import "./chai.types.js";
+import "./chaiTypes.js";
 import chaiPlugin from "./chaiPlugin.js";
 chai.use(chaiDom);
-chai.use(chaiPlugin);
+chai.use(chaiPlugin);
+
+// Make sure to export the chai instance and plugins for declarations
+export { chai, chaiDom, chaiPlugin };

package/esm/setupVitest.d.ts

@@ -1 +1,8 @@
-import "./chai.types.js";
+import "./chaiTypes.js";
+import { Configuration } from "./configure.js";
+export default function setupVitest({
+  failOnConsoleEnabled,
+  ...config
+}?: Partial<Configuration> & {
+  failOnConsoleEnabled?: boolean;
+}): void;

package/esm/setupVitest.js

@@ -1,28 +1,94 @@
 import failOnConsole from 'vitest-fail-on-console';
 import * as chai from 'chai';
-import "./chai.types.js";
+import "./chaiTypes.js";
+// eslint-disable-next-line import/extensions
+import { cleanup, act } from '@testing-library/react/pure.js';
+import { afterEach, vi } from 'vitest';
+import chaiDom from 'chai-dom';
 import chaiPlugin from "./chaiPlugin.js";
-chai.use(chaiPlugin);
-failOnConsole({
-  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;
+import { configure } from "./configure.js";
+let isInitialized = false;
+export default function setupVitest({
+  failOnConsoleEnabled = true,
+  ...config
+} = {}) {
+  // When run in vitest with --no-isolate, the test hooks are cleared between each suite,
+  // but modules are only evaluated once, so calling it top-level would only register the
+  // hooks for the first suite only.
+  // Instead call `setupVitest` in one of the `setupFiles`, which are not cached and executed
+  // per suite.
+
+  afterEach(async () => {
+    if (vi.isFakeTimers()) {
+      await act(async () => {
+        vi.runOnlyPendingTimers();
+      });
     }
+    vi.useRealTimers();
+    cleanup();
+  });
+  if (isInitialized) {
+    return;
+  }
+  configure(config);
+  isInitialized = true;
+
+  // Don't call test lifecycle hooks after this point
+
+  chai.use(chaiPlugin);
+  if (failOnConsoleEnabled) {
+    failOnConsole({
+      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;
+      }
+    });
+  }
+  if (typeof window !== 'undefined') {
+    chai.use(chaiDom);
 
-    // 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;
+    // 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;
+        }
+      };
     }
-    return false;
   }
-});
+}

package/flushMicrotasks.d.ts

@@ -1 +1 @@
-export default function flushMicrotasks(): Promise<void>;
+export declare function flushMicrotasks(): Promise<void>;

package/flushMicrotasks.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = flushMicrotasks;
+exports.flushMicrotasks = flushMicrotasks;
 var _createRenderer = require("./createRenderer");
 async function flushMicrotasks() {
   await (0, _createRenderer.act)(async () => {});

package/index.d.ts

@@ -1,18 +1,10 @@
+import "./initMatchers.js";
 export * from "./components.js";
 export { default as describeConformance } from "./describeConformance.js";
 export * from "./describeConformance.js";
 export { default as createDescribe } from "./createDescribe.js";
 export * from "./createRenderer.js";
 export { default as focusVisible, simulatePointerDevice, simulateKeyboardDevice, programmaticFocusTriggersFocusVisible } from "./focusVisible.js";
-export {} from "./initMatchers.js";
-export * as fireDiscreteEvent from "./fireDiscreteEvent.js";
-export { default as flushMicrotasks } from "./flushMicrotasks.js";
-export { default as reactMajor } from "./reactMajor.js";
-export * from "./env.js";
-/**
- * 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
- */
-export declare const strictModeDoubleLoggingSuppressed: boolean;
+export { fireEvent as fireDiscreteEvent } from '@testing-library/react/pure.js';
+export { flushMicrotasks } from "./flushMicrotasks.js";
+export * from "./env.js";

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/internal-test-utils v2.0.16
+ * @mui/internal-test-utils v2.0.17
  *
  * @license undefined
  * This source code is licensed under the undefined license found in the
@@ -13,7 +13,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 var _exportNames = {
-  strictModeDoubleLoggingSuppressed: true,
   describeConformance: true,
   createDescribe: true,
   focusVisible: true,
@@ -21,8 +20,7 @@ var _exportNames = {
   simulateKeyboardDevice: true,
   programmaticFocusTriggersFocusVisible: true,
   fireDiscreteEvent: true,
-  flushMicrotasks: true,
-  reactMajor: true
+  flushMicrotasks: true
 };
 Object.defineProperty(exports, "createDescribe", {
   enumerable: true,
@@ -36,11 +34,16 @@ Object.defineProperty(exports, "describeConformance", {
     return _describeConformance.default;
   }
 });
-exports.fireDiscreteEvent = void 0;
+Object.defineProperty(exports, "fireDiscreteEvent", {
+  enumerable: true,
+  get: function () {
+    return _pure.fireEvent;
+  }
+});
 Object.defineProperty(exports, "flushMicrotasks", {
   enumerable: true,
   get: function () {
-    return _flushMicrotasks.default;
+    return _flushMicrotasks.flushMicrotasks;
   }
 });
 Object.defineProperty(exports, "focusVisible", {
@@ -55,12 +58,6 @@ Object.defineProperty(exports, "programmaticFocusTriggersFocusVisible", {
     return _focusVisible.programmaticFocusTriggersFocusVisible;
   }
 });
-Object.defineProperty(exports, "reactMajor", {
-  enumerable: true,
-  get: function () {
-    return _reactMajor.default;
-  }
-});
 Object.defineProperty(exports, "simulateKeyboardDevice", {
   enumerable: true,
   get: function () {
@@ -73,8 +70,7 @@ Object.defineProperty(exports, "simulatePointerDevice", {
     return _focusVisible.simulatePointerDevice;
   }
 });
-exports.strictModeDoubleLoggingSuppressed = void 0;
-var React = _interopRequireWildcard(require("react"));
+require("./initMatchers");
 var _components = require("./components");
 Object.keys(_components).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -113,11 +109,8 @@ Object.keys(_createRenderer).forEach(function (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 _pure = require("@testing-library/react/pure.js");
+var _flushMicrotasks = require("./flushMicrotasks");
 var _env = require("./env");
 Object.keys(_env).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -129,11 +122,4 @@ Object.keys(_env).forEach(function (key) {
       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/initMatchers.d.ts

@@ -1 +1,5 @@
-import "./chai.types.js";
+import * as chai from 'chai';
+import chaiDom from 'chai-dom';
+import "./chaiTypes.js";
+import chaiPlugin from "./chaiPlugin.js";
+export { chai, chaiDom, chaiPlugin };

package/initMatchers.js

@@ -2,9 +2,28 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.chai = void 0;
+Object.defineProperty(exports, "chaiDom", {
+  enumerable: true,
+  get: function () {
+    return _chaiDom.default;
+  }
+});
+Object.defineProperty(exports, "chaiPlugin", {
+  enumerable: true,
+  get: function () {
+    return _chaiPlugin.default;
+  }
+});
 var chai = _interopRequireWildcard(require("chai"));
+exports.chai = chai;
 var _chaiDom = _interopRequireDefault(require("chai-dom"));
-require("./chai.types");
+require("./chaiTypes");
 var _chaiPlugin = _interopRequireDefault(require("./chaiPlugin"));
 chai.use(_chaiDom.default);
-chai.use(_chaiPlugin.default);
+chai.use(_chaiPlugin.default);
+
+// Make sure to export the chai instance and plugins for declarations

package/package.json

@@ -1,35 +1,45 @@
 {
   "name": "@mui/internal-test-utils",
-  "version": "2.0.16",
+  "version": "2.0.18-canary.1",
   "author": "MUI Team",
   "description": "Utilities for MUI tests. This is an internal package not meant for general use.",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mui/material-ui.git",
-    "directory": "packages-internal/test-utils"
+    "url": "git+https://github.com/mui/mui-public.git",
+    "directory": "packages/test-utils"
   },
   "dependencies": {
+    "@types/chai-dom": "^1.11.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/react": "^16.3.1",
     "@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.41.0",
+    "dom-accessibility-api": "^0.7.1",
+    "es-toolkit": "^1.43.0",
     "format-util": "^1.0.5",
     "jsdom": "^26.1.0",
     "prop-types": "^15.8.1",
-    "sinon": "^21.0.0"
+    "sinon": "^21.0.1",
+    "vitest-fail-on-console": "^0.10.1"
   },
   "peerDependencies": {
+    "@emotion/cache": "11",
+    "@emotion/react": "11",
     "@playwright/test": "^1.53.1",
     "chai": "^4.5.0 || ^5.0.0 || ^6.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@emotion/cache": {
+      "optional": true
+    },
+    "@emotion/react": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -68,16 +78,6 @@
         "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",
@@ -88,6 +88,16 @@
         "default": "./esm/initMatchers.js"
       }
     },
+    "./env": {
+      "require": {
+        "types": "./env.d.ts",
+        "default": "./env.js"
+      },
+      "default": {
+        "types": "./esm/env.d.ts",
+        "default": "./esm/env.js"
+      }
+    },
     "./initPlaywrightMatchers": {
       "require": {
         "types": "./initPlaywrightMatchers.d.ts",
@@ -119,5 +129,6 @@
       }
     },
     "./esm": null
-  }
+  },
+  "gitSha": "7f5c7019e5ec5cc1413a5d6d22137941bba633c8"
 }

package/setupVitest.d.ts

@@ -1 +1,8 @@
-import "./chai.types.js";
+import "./chaiTypes.js";
+import { Configuration } from "./configure.js";
+export default function setupVitest({
+  failOnConsoleEnabled,
+  ...config
+}?: Partial<Configuration> & {
+  failOnConsoleEnabled?: boolean;
+}): void;

package/setupVitest.js

@@ -2,31 +2,103 @@
 
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = setupVitest;
 var _vitestFailOnConsole = _interopRequireDefault(require("vitest-fail-on-console"));
 var chai = _interopRequireWildcard(require("chai"));
-require("./chai.types");
+require("./chaiTypes");
+var _pure = require("@testing-library/react/pure.js");
+var _vitest = require("vitest");
+var _chaiDom = _interopRequireDefault(require("chai-dom"));
 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;
+var _configure = require("./configure");
+// eslint-disable-next-line import/extensions
+
+let isInitialized = false;
+function setupVitest({
+  failOnConsoleEnabled = true,
+  ...config
+} = {}) {
+  // When run in vitest with --no-isolate, the test hooks are cleared between each suite,
+  // but modules are only evaluated once, so calling it top-level would only register the
+  // hooks for the first suite only.
+  // Instead call `setupVitest` in one of the `setupFiles`, which are not cached and executed
+  // per suite.
+
+  (0, _vitest.afterEach)(async () => {
+    if (_vitest.vi.isFakeTimers()) {
+      await (0, _pure.act)(async () => {
+        _vitest.vi.runOnlyPendingTimers();
+      });
     }
+    _vitest.vi.useRealTimers();
+    (0, _pure.cleanup)();
+  });
+  if (isInitialized) {
+    return;
+  }
+  (0, _configure.configure)(config);
+  isInitialized = true;
+
+  // Don't call test lifecycle hooks after this point
+
+  chai.use(_chaiPlugin.default);
+  if (failOnConsoleEnabled) {
+    (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;
+      }
+    });
+  }
+  if (typeof window !== 'undefined') {
+    chai.use(_chaiDom.default);
 
-    // 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;
+    // 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')) {
+      var _window;
+      // Not yet supported: https://github.com/jsdom/jsdom/issues/2152
+      (_window = globalThis.window).Touch ?? (_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;
+        }
+      });
     }
-    return false;
   }
-});
+}

package/createDOM.d.ts

@@ -1,2 +0,0 @@
-export = createDOM;
-declare function createDOM(): void;