@mui/internal-test-utils 2.0.14 → 2.0.16

package/esm/env.d.ts

@@ -0,0 +1 @@
+export declare function isJsdom(): boolean;

package/esm/env.js

@@ -0,0 +1,5 @@
+/* eslint-disable import/prefer-default-export */
+
+export function isJsdom() {
+  return window.navigator.userAgent.includes('jsdom');
+}

package/{build → esm}/fireDiscreteEvent.d.ts

@@ -3,5 +3,4 @@ export declare function click(...args: Parameters<(typeof fireEvent)['click']>):
 export declare function keyDown(...args: Parameters<(typeof fireEvent)['keyDown']>): void;
 export declare function keyUp(...args: Parameters<(typeof fireEvent)['keyUp']>): void;
 export declare function mouseDown(...args: Parameters<(typeof fireEvent)['mouseDown']>): void;
-export declare function mouseUp(...args: Parameters<(typeof fireEvent)['mouseUp']>): void;
-//# sourceMappingURL=fireDiscreteEvent.d.ts.map
+export declare function mouseUp(...args: Parameters<(typeof fireEvent)['mouseUp']>): void;

package/{src/fireDiscreteEvent.ts → esm/fireDiscreteEvent.js}

@@ -1,18 +1,16 @@
 import { configure, fireEvent, getConfig } from '@testing-library/react/pure';
-import reactMajor from './reactMajor';
-
-const noWrapper = (callback: () => void) => callback();
+import reactMajor from "./reactMajor.js";
+const noWrapper = callback => callback();
 
 /**
  * @param {() => void} callback
  * @returns {void}
  */
-function withMissingActWarningsIgnored(callback: () => void) {
+function withMissingActWarningsIgnored(callback) {
   if (reactMajor >= 18) {
     callback();
     return;
   }
-
   const originalConsoleError = console.error;
   console.error = function silenceMissingActWarnings(message, ...args) {
     const isMissingActWarning = /not wrapped in act\(...\)/.test(message);
@@ -20,12 +18,10 @@ function withMissingActWarningsIgnored(callback: () => void) {
       originalConsoleError.call(console, message, ...args);
     }
   };
-
   const originalConfig = getConfig();
   configure({
-    eventWrapper: noWrapper,
+    eventWrapper: noWrapper
   });
-
   try {
     callback();
   } finally {
@@ -45,32 +41,28 @@ function withMissingActWarningsIgnored(callback: () => void) {
 // Note that using `fireEvent` from `@testing-library/dom` would not work since /react configures both `fireEvent` to use `act` as a wrapper.
 // -----------------------------------------
 
-export function click(...args: Parameters<(typeof fireEvent)['click']>) {
+export function click(...args) {
   return withMissingActWarningsIgnored(() => {
     fireEvent.click(...args);
   });
 }
-
-export function keyDown(...args: Parameters<(typeof fireEvent)['keyDown']>) {
+export function keyDown(...args) {
   return withMissingActWarningsIgnored(() => {
     fireEvent.keyDown(...args);
   });
 }
-
-export function keyUp(...args: Parameters<(typeof fireEvent)['keyUp']>) {
+export function keyUp(...args) {
   return withMissingActWarningsIgnored(() => {
     fireEvent.keyUp(...args);
   });
 }
-
-export function mouseDown(...args: Parameters<(typeof fireEvent)['mouseDown']>) {
+export function mouseDown(...args) {
   return withMissingActWarningsIgnored(() => {
     fireEvent.mouseDown(...args);
   });
 }
-
-export function mouseUp(...args: Parameters<(typeof fireEvent)['mouseUp']>) {
+export function mouseUp(...args) {
   return withMissingActWarningsIgnored(() => {
     fireEvent.mouseUp(...args);
   });
-}
+}

package/esm/flushMicrotasks.d.ts

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

package/{src/flushMicrotasks.ts → esm/flushMicrotasks.js}

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

package/{build → esm}/focusVisible.d.ts

@@ -4,5 +4,4 @@ export declare function simulateKeyboardDevice(): void;
 /**
  * See https://issues.chromium.org/issues/40719291 for more details.
  */
-export declare function programmaticFocusTriggersFocusVisible(): boolean;
-//# sourceMappingURL=focusVisible.d.ts.map
+export declare function programmaticFocusTriggersFocusVisible(): boolean;

package/{src/focusVisible.ts → esm/focusVisible.js}

@@ -1,29 +1,30 @@
-import { act, fireEvent } from './createRenderer';
-
-export default function focusVisible(element: HTMLElement) {
+import { act, fireEvent } from "./createRenderer.js";
+export default function focusVisible(element) {
   act(() => {
     element.blur();
   });
-  fireEvent.keyDown(document.body, { key: 'Tab' });
+  fireEvent.keyDown(document.body, {
+    key: 'Tab'
+  });
   act(() => {
     element.focus();
   });
 }
-
 export function simulatePointerDevice() {
   // first focus on a page triggers focus visible until a pointer event
   // has been dispatched
   fireEvent.pointerDown(document.body);
 }
-
 export function simulateKeyboardDevice() {
-  fireEvent.keyDown(document.body, { key: 'TAB' });
+  fireEvent.keyDown(document.body, {
+    key: 'TAB'
+  });
 }
 
 /**
  * See https://issues.chromium.org/issues/40719291 for more details.
  */
-export function programmaticFocusTriggersFocusVisible(): boolean {
+export function programmaticFocusTriggersFocusVisible() {
   try {
     // So far this only applies to Chrome 86 beta which is the only tested browser supporting this pseudo class.
     document.createElement('button').matches(':focus-visible');
@@ -31,4 +32,4 @@ export function programmaticFocusTriggersFocusVisible(): boolean {
   } catch (error) {
     return false;
   }
-}
+}

package/esm/index.d.ts

@@ -0,0 +1,18 @@
+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;

package/esm/index.js

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+import * as React from 'react';
+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');

package/esm/init.d.ts

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

package/{src → esm}/init.js

@@ -1,5 +1,5 @@
 import * as testingLibrary from '@testing-library/react/pure';
-import './initMatchers';
+import "./initMatchers.js";
 
 // 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
@@ -8,4 +8,6 @@ import './initMatchers';
 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 });
+testingLibrary.configure({
+  defaultHidden
+});

package/esm/initMatchers.d.ts

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

package/esm/initMatchers.js

@@ -0,0 +1,6 @@
+import * as chai from 'chai';
+import chaiDom from 'chai-dom';
+import "./chai.types.js";
+import chaiPlugin from "./chaiPlugin.js";
+chai.use(chaiDom);
+chai.use(chaiPlugin);

package/esm/initMatchers.test.d.ts

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

package/esm/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/esm/initPlaywrightMatchers.js

@@ -0,0 +1,40 @@
+import * as chai from 'chai';
+import { AssertionError } from '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(`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(`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/esm/package.json

@@ -0,0 +1 @@
+{"type":"module","sideEffects":false}

package/esm/reactMajor.d.ts

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

package/esm/reactMajor.js

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export default parseInt(React.version, 10);

package/esm/setup.d.ts

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

package/{src → esm}/setup.js

@@ -1,10 +1,8 @@
 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,
-});
+  computedStyleSupportsPseudoElements: false
+});

package/esm/setupVitest.d.ts

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

package/esm/setupVitest.js

@@ -0,0 +1,28 @@
+import failOnConsole from 'vitest-fail-on-console';
+import * as chai from 'chai';
+import "./chai.types.js";
+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;
+    }
+
+    // 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/esm/setupVitestBrowser.d.ts

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

package/esm/setupVitestBrowser.js

@@ -0,0 +1,30 @@
+import * as chai from 'chai';
+import chaiDom from 'chai-dom';
+chai.use(chaiDom);
+
+// 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;
+    }
+  };
+}

package/fireDiscreteEvent.d.ts

@@ -0,0 +1,6 @@
+import { fireEvent } from '@testing-library/react/pure';
+export declare function click(...args: Parameters<(typeof fireEvent)['click']>): void;
+export declare function keyDown(...args: Parameters<(typeof fireEvent)['keyDown']>): void;
+export declare function keyUp(...args: Parameters<(typeof fireEvent)['keyUp']>): void;
+export declare function mouseDown(...args: Parameters<(typeof fireEvent)['mouseDown']>): void;
+export declare function mouseUp(...args: Parameters<(typeof fireEvent)['mouseUp']>): void;

package/fireDiscreteEvent.js

@@ -0,0 +1,79 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.click = click;
+exports.keyDown = keyDown;
+exports.keyUp = keyUp;
+exports.mouseDown = mouseDown;
+exports.mouseUp = mouseUp;
+var _pure = require("@testing-library/react/pure");
+var _reactMajor = _interopRequireDefault(require("./reactMajor"));
+const noWrapper = callback => callback();
+
+/**
+ * @param {() => void} callback
+ * @returns {void}
+ */
+function withMissingActWarningsIgnored(callback) {
+  if (_reactMajor.default >= 18) {
+    callback();
+    return;
+  }
+  const originalConsoleError = console.error;
+  console.error = function silenceMissingActWarnings(message, ...args) {
+    const isMissingActWarning = /not wrapped in act\(...\)/.test(message);
+    if (!isMissingActWarning) {
+      originalConsoleError.call(console, message, ...args);
+    }
+  };
+  const originalConfig = (0, _pure.getConfig)();
+  (0, _pure.configure)({
+    eventWrapper: noWrapper
+  });
+  try {
+    callback();
+  } finally {
+    (0, _pure.configure)(originalConfig);
+    console.error = originalConsoleError;
+  }
+}
+
+// -----------------------------------------
+// WARNING ⚠️ WARNING ⚠️ WARNING ⚠️ WARNING
+//
+// Do not add events here because you want to ignore "missing act()" warnings.
+// Only add events if you made sure that React actually considers these as "discrete".
+// Be aware that "discrete events" are an implementation detail of React.
+// To test discrete events we cannot use `fireEvent` from `@testing-library/react` because they are all wrapped in `act`.
+// `act` overrides the "discrete event" semantics with "batching" semantics: https://github.com/facebook/react/blob/3fbd47b86285b6b7bdeab66d29c85951a84d4525/packages/react-reconciler/src/ReactFiberWorkLoop.old.js#L1061-L1064
+// Note that using `fireEvent` from `@testing-library/dom` would not work since /react configures both `fireEvent` to use `act` as a wrapper.
+// -----------------------------------------
+
+function click(...args) {
+  return withMissingActWarningsIgnored(() => {
+    _pure.fireEvent.click(...args);
+  });
+}
+function keyDown(...args) {
+  return withMissingActWarningsIgnored(() => {
+    _pure.fireEvent.keyDown(...args);
+  });
+}
+function keyUp(...args) {
+  return withMissingActWarningsIgnored(() => {
+    _pure.fireEvent.keyUp(...args);
+  });
+}
+function mouseDown(...args) {
+  return withMissingActWarningsIgnored(() => {
+    _pure.fireEvent.mouseDown(...args);
+  });
+}
+function mouseUp(...args) {
+  return withMissingActWarningsIgnored(() => {
+    _pure.fireEvent.mouseUp(...args);
+  });
+}

package/flushMicrotasks.d.ts

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

package/flushMicrotasks.js

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

package/focusVisible.d.ts

@@ -0,0 +1,7 @@
+export default function focusVisible(element: HTMLElement): void;
+export declare function simulatePointerDevice(): void;
+export declare function simulateKeyboardDevice(): void;
+/**
+ * See https://issues.chromium.org/issues/40719291 for more details.
+ */
+export declare function programmaticFocusTriggersFocusVisible(): boolean;

package/focusVisible.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = focusVisible;
+exports.programmaticFocusTriggersFocusVisible = programmaticFocusTriggersFocusVisible;
+exports.simulateKeyboardDevice = simulateKeyboardDevice;
+exports.simulatePointerDevice = simulatePointerDevice;
+var _createRenderer = require("./createRenderer");
+function focusVisible(element) {
+  (0, _createRenderer.act)(() => {
+    element.blur();
+  });
+  _createRenderer.fireEvent.keyDown(document.body, {
+    key: 'Tab'
+  });
+  (0, _createRenderer.act)(() => {
+    element.focus();
+  });
+}
+function simulatePointerDevice() {
+  // first focus on a page triggers focus visible until a pointer event
+  // has been dispatched
+  _createRenderer.fireEvent.pointerDown(document.body);
+}
+function simulateKeyboardDevice() {
+  _createRenderer.fireEvent.keyDown(document.body, {
+    key: 'TAB'
+  });
+}
+
+/**
+ * See https://issues.chromium.org/issues/40719291 for more details.
+ */
+function programmaticFocusTriggersFocusVisible() {
+  try {
+    // So far this only applies to Chrome 86 beta which is the only tested browser supporting this pseudo class.
+    document.createElement('button').matches(':focus-visible');
+    return true;
+  } catch (error) {
+    return false;
+  }
+}

package/index.d.ts

@@ -0,0 +1,18 @@
+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;