@mui/internal-test-utils 1.0.19 → 1.0.20

package/build/setupVitest.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const testingLibrary = __importStar(require("@testing-library/dom"));
+const vitest_fail_on_console_1 = __importDefault(require("vitest-fail-on-console"));
+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({
+    // JSDOM logs errors otherwise on `getComputedStyle(element, pseudoElement)` calls.
+    computedStyleSupportsPseudoElements: false,
+    defaultHidden,
+});
+// Enable missing act warnings: https://github.com/reactwg/react-18/discussions/102
+globalThis.jest = null;
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+(0, vitest_fail_on_console_1.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;
+    },
+});
+function wrapIt(itFn) {
+    return function wrapper(name, fn) {
+        return itFn(name, (context) => {
+            return fn?.call({
+                ...context,
+                currentTest: {
+                    fullTitle: () => context.task.name,
+                },
+            });
+        });
+    };
+}
+const wrappedIt = wrapIt(vitest_1.it);
+wrappedIt.skip = wrapIt(vitest_1.it.skip);
+wrappedIt.only = wrapIt(vitest_1.it.only);
+globalThis.it = wrappedIt;
+if (!globalThis.before) {
+    globalThis.before = vitest_1.beforeAll;
+}
+if (!globalThis.after) {
+    globalThis.after = vitest_1.afterAll;
+}
+if (!globalThis.specify) {
+    globalThis.specify = wrappedIt;
+}
+const isJsdom = typeof window !== 'undefined' && window.navigator.userAgent.includes('jsdom');
+// Only necessary when not in browser mode.
+if (isJsdom) {
+    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;
+        }
+    }
+    // @ts-expect-error
+    globalThis.window.Touch = Touch;
+}
+//# sourceMappingURL=setupVitest.js.map

package/build/setupVitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupVitest.js","sourceRoot":"","sources":["../src/setupVitest.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-test-utils",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "author": "MUI Team",
   "description": "Utilities for MUI tests. This is an internal package not meant for general use.",
   "main": "./build/index.js",
@@ -21,7 +21,9 @@
     "./setupBabel": "./build/setupBabel.js",
     "./setupBabelPlaywright": "./build/setupBabelPlaywright.js",
     "./setupJSDOM": "./build/setupJSDOM.js",
-    "./setupKarma": "./build/setupKarma.js"
+    "./setupKarma": "./build/setupKarma.js",
+    "./chaiPlugin": "./build/chaiPlugin.js",
+    "./setupVitest": "./build/setupVitest.js"
   },
   "dependencies": {
     "@babel/plugin-transform-modules-commonjs": "^7.25.9",
@@ -40,10 +42,10 @@
     "fs-extra": "^11.2.0",
     "jsdom": "^24.0.0",
     "lodash": "^4.17.21",
-    "mocha": "^10.7.3",
+    "mocha": "^10.8.2",
     "playwright": "^1.48.2",
     "prop-types": "^15.8.1",
-    "sinon": "^18.0.1"
+    "sinon": "^19.0.2"
   },
   "devDependencies": {
     "@types/chai": "^4.3.20",

package/src/chai.types.ts

@@ -0,0 +1,106 @@
+export {};
+
+// https://stackoverflow.com/a/46755166/3406963
+declare global {
+  namespace Chai {
+    interface Assertion {
+      /**
+       * Checks `expectedStyle` is a subset of the elements inline style i.e. `element.style`.
+       * @example expect(element).toHaveInlineStyle({ width: '200px' })
+       */
+      toHaveInlineStyle(
+        expectedStyle: Partial<
+          Record<
+            Exclude<
+              keyof CSSStyleDeclaration,
+              | 'getPropertyPriority'
+              | 'getPropertyValue'
+              | 'item'
+              | 'removeProperty'
+              | 'setProperty'
+              | number
+            >,
+            string
+          >
+        >,
+      ): void;
+      /**
+       * Checks `expectedStyle` is a subset of the elements computed style i.e. `window.getComputedStyle(element)`.
+       * @example expect(element).toHaveComputedStyle({ width: '200px' })
+       */
+      toHaveComputedStyle(
+        expectedStyle: Partial<
+          Record<
+            Exclude<
+              keyof CSSStyleDeclaration,
+              | 'getPropertyPriority'
+              | 'getPropertyValue'
+              | 'item'
+              | 'removeProperty'
+              | 'setProperty'
+              | number
+            >,
+            string
+          >
+        >,
+      ): void;
+      /**
+       * Check if an element's [`visibility`](https://developer.mozilla.org/en-US/docs/Web/CSS/visibility) is not `hidden` or `collapsed`.
+       */
+      toBeVisible(): void;
+      /**
+       * Check if an element's [`visibility`](https://developer.mozilla.org/en-US/docs/Web/CSS/visibility) is `hidden` or `collapsed`.
+       */
+      toBeHidden(): void;
+      /**
+       * Checks if the element is inaccessible.
+       *
+       * Elements are considered inaccessible if they either:
+       * - have [`visibility`](https://developer.mozilla.org/en-US/docs/Web/CSS/visibility) `hidden`
+       * - have [`display`](https://developer.mozilla.org/en-US/docs/Web/CSS/display) `none`
+       * - have `aria-hidden` `true` or any of their parents
+       *
+       * @see [Excluding Elements from the Accessibility Tree](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion)
+       */
+      toBeInaccessible(): void;
+      toHaveAccessibleDescription(description: string): void;
+      /**
+       * Checks if the accessible name computation (according to `accname` spec)
+       * matches the expectation.
+       *
+       * @see https://www.w3.org/TR/accname-1.2/
+       * @param name
+       */
+      toHaveAccessibleName(name: string): void;
+      /**
+       * Checks if the element is actually focused i.e. `document.activeElement` is equal to the actual element.
+       */
+      toHaveFocus(): void;
+      /**
+       * Checks if the element is the active-descendant of the active element.
+       */
+      toHaveVirtualFocus(): void;
+      /**
+       * Matches calls to `console.warn` in the asserted callback.
+       *
+       * @example expect(() => render()).not.toWarnDev()
+       * @example expect(() => render()).toWarnDev('single message')
+       * @example expect(() => render()).toWarnDev(['first warning', 'then the second'])
+       */
+      toWarnDev(messages?: string | readonly (string | boolean)[]): void;
+      /**
+       * Matches calls to `console.error` in the asserted callback.
+       *
+       * @example expect(() => render()).not.toErrorDev()
+       * @example expect(() => render()).toErrorDev('single message')
+       * @example expect(() => render()).toErrorDev(['first warning', 'then the second'])
+       */
+      toErrorDev(messages?: string | readonly (string | boolean)[]): void;
+      /**
+       * Asserts that the given callback throws an error matching the given message in development (process.env.NODE_ENV !== 'production').
+       * In production it expects a minified error.
+       */
+      toThrowMinified(message: string): void;
+    }
+  }
+}