@databricks/design-system 1.9.1 → 1.10.0

package/dist/test-utils/common.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Used with the `selectEvent` utils for both Enzyme and RTL.
+ */
+export declare const selectClasses: {
+    clear: string;
+    list: string;
+    open: string;
+    option: string;
+    selector: string;
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/test-utils/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/test-utils/common.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMzB,CAAC"}

package/dist/test-utils/enzyme/index.d.ts

@@ -1,4 +1,5 @@
 import type { ReactWrapper } from 'enzyme';
+export * as selectEvent from './selectEvent';
 /**
  * Open a dropdown menu by simulating a pointerDown event on the dropdown button.
  *

package/dist/test-utils/enzyme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test-utils/enzyme/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,mBAAoB,YAAY,SAE5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test-utils/enzyme/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,mBAAoB,YAAY,SAE5D,CAAC"}

package/dist/test-utils/enzyme/selectEvent.d.ts

@@ -0,0 +1,42 @@
+import type { ReactWrapper } from 'enzyme';
+/**
+ * Clicks on the "Clear" button. In order for this function to work properly,
+ * the `allowClear` prop must be set to `true`.
+ */
+export declare function clearAll(getSelect: () => ReactWrapper): void;
+/**
+ * Closes the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already closed or if the menu is unable to be closed.
+ */
+export declare function closeMenu(getSelect: () => ReactWrapper): Promise<void>;
+/**
+ * Returns a string concatenating the labels for all selected options.
+ */
+export declare function getLabelText(getSelect: () => ReactWrapper): string;
+/**
+ * Selects options from the dropdown menu for a <Select/> component with `mode="multiple"`.
+ * The provided strings must match the option labels exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+export declare function multiSelect(getSelect: () => ReactWrapper, options: string[]): Promise<void>;
+/**
+ * Selects options from the dropdown menu for a <Select/> component without a
+ * mode. The provided string must match an option label exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+export declare function singleSelect(getSelect: () => ReactWrapper, option: string): Promise<void>;
+/**
+ * Opens the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already opened or if the menu is unable to be opened.
+ */
+export declare function openMenu(getSelect: () => ReactWrapper): Promise<void>;
+/**
+ * Opens the dropdown menu, finds all of the options in the dropdown, closes
+ * the menu, and returns a list of the text of each option in order.
+ */
+export declare function getAllOptions(getSelect: () => ReactWrapper): Promise<string[]>;
+//# sourceMappingURL=selectEvent.d.ts.map

package/dist/test-utils/enzyme/selectEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectEvent.d.ts","sourceRoot":"","sources":["../../../src/test-utils/enzyme/selectEvent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAK3C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,MAAM,CAKlE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQpF"}

package/dist/test-utils/enzyme/selectEvent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selectEvent.test.d.ts.map

package/dist/test-utils/enzyme/selectEvent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectEvent.test.d.ts","sourceRoot":"","sources":["../../../src/test-utils/enzyme/selectEvent.test.tsx"],"names":[],"mappings":""}

package/dist/test-utils/enzyme/utils.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="react" />
+import type { ReactWrapper } from 'enzyme';
+interface QueryOptions {
+    /** Whether to trim the whitespace from DOM text using `String.prototype.trim` */
+    trim?: boolean;
+}
+/**
+ * Finds a single element that contains the specified text in the wrapper. If
+ * there are 0 or more than 1 element that contains the specified text, an error
+ * is thrown. Returns the element in an enzyme wrapper.
+ */
+export declare function findByText<P, S, C>(wrapper: ReactWrapper<P, S, C>, text: string | RegExp, queryOptions?: QueryOptions): ReactWrapper<any, any, import("react").Component<{}, {}, any>>;
+/**
+ * Finds all elements that contain the specified text. To avoid duplicate results,
+ * only the parents of text nodes are returned.
+ */
+export declare function findAllByText<P, S, C>(wrapper: ReactWrapper<P, S, C>, text: string | RegExp, { trim }?: QueryOptions): ReactWrapper<any, any, import("react").Component<{}, {}, any>>[];
+interface WaitForOptions {
+    interval?: number;
+    stackTraceError?: Error;
+    timeout?: number;
+}
+/**
+ * Wraps `_waitFor` in React's `act` testing utility. Used when the React component
+ * updates during the execution of the callback (either because of indirect effects
+ * being run or because of direct requests to update the component, like wrapper.update).
+ * Prevents updates related to the callback from being affected by other updates
+ * and more closely mimics how React runs in the browser. See
+ * https://reactjs.org/docs/test-utils.html#act for more info on `act`.
+ */
+export declare function waitFor<T>(callback: () => T | Promise<T>, options?: WaitForOptions): Promise<T>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/test-utils/enzyme/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/test-utils/enzyme/utils.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG3C,UAAU,YAAY;IACpB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,YAAY,CAAC,EAAE,YAAY,kEAS5B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,EAAE,IAAY,EAAE,GAAE,YAAiB,oEA0BpC;AAkBD,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAYrG"}

package/dist/test-utils/enzyme.js

@@ -1,5 +1,262 @@
+import { s as selectClasses } from '../common-3ab0e300.js';
+import { act } from 'react-dom/test-utils';
+
+// eslint-disable-next-line @databricks/no-restricted-imports-regexp
+/**
+ * Finds a single element that contains the specified text in the wrapper. If
+ * there are 0 or more than 1 element that contains the specified text, an error
+ * is thrown. Returns the element in an enzyme wrapper.
+ */
+function findByText(wrapper, text, queryOptions) {
+  const newWrappers = findAllByText(wrapper, text, queryOptions);
+  if (newWrappers.length !== 1) {
+    throw new Error("Expected to find 1 node but found ".concat(newWrappers.length, " nodes for text \"").concat(text, "\".\n").concat(wrapper.debug()));
+  }
+  return newWrappers[0];
+}
+
+/**
+ * Finds all elements that contain the specified text. To avoid duplicate results,
+ * only the parents of text nodes are returned.
+ */
+function findAllByText(wrapper, text) {
+  let {
+    trim = false
+  } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const textNodes = wrapper.findWhere(n => {
+    if (n.type() !== undefined) {
+      return false;
+    }
+    let nodeText = n.text();
+    if (trim) {
+      nodeText = nodeText.trim();
+    }
+    return typeof text === 'string' ? nodeText === text : text.test(nodeText);
+  });
+  const newWrappers = textNodes.map(n => {
+    const textNodeParent = n.parents().first();
+    if (textNodeParent.name() === 'FormattedMessage') {
+      // Try not to return FormattedMessage since it breaks `simulate` due to a bug in `enzyme-adapter-react-17`
+      // Similar to https://github.com/wojtekmaj/enzyme-adapter-react-17/issues/45
+      const formattedMessageParents = textNodeParent.parents();
+      return formattedMessageParents.length > 0 ? formattedMessageParents.first() : textNodeParent;
+    } else {
+      return textNodeParent;
+    }
+  });
+  return newWrappers;
+}
+
+// We need to keep ref to original setTimeout to avoid SinonJS fake timers if enabled
+const originalSetTimeout = window.setTimeout;
+
+/**
+ * This is so the stack trace the developer sees is one that's
+ * closer to their code (because async stack traces are hard to follow).
+ *
+ * The code is taken from
+ * https://github.com/testing-library/dom-testing-library/blob/f7b5c33c44632fba
+ * 1579cb44f9f175be1ec46087/src/wait-for.js#L15-L19
+ */
+function copyStackTrace(target, source) {
+  // eslint-disable-next-line no-param-reassign
+  target.stack = source.stack.replace(source.message, target.message);
+}
+/**
+ * Run an expectation until it succeeds or reaches the timeout. The timeout of 1500ms
+ * is chosen to be under the default Karma test timeout of 2000ms. This function will
+ * not work properly if fake timers are being used (since it expects the real setTimeout).
+ *
+ * The code is taken from
+ * https://github.com/TheBrainFamily/wait-for-expect/blob/master/src/index.ts,
+ * with slight modifications to support Karma (instead of Jest).
+ *
+ *
+ * Example
+ * The <App /> component does not render the header synchronously.
+ * Therefore, we cannot check that the wrapper's text is equal to the string
+ * immediately--this assertion will fail and cause the test to fail. To
+ * remediate this issue, we can run the expectation until it succeeds:
+ *
+ * function App() {
+ *   const [value, setValue] = useState(null);
+ *   useEffect(() => {
+ *     const timeoutId = setTimeout(() => setValue("some value"), 100);
+ *     return () => clearTimeout(timeoutId);
+ *   }, []);
+ *   return value === null ? null : <h1>The value is: {value}</h1>;
+ * }
+ *
+ * it('renders value', async () => {
+ *   const wrapper = mount(<App />);
+ *   await waitFor(() =>
+ *     wrapper.update();
+ *     expect(wrapper.text()).to.equal("The value is: some value")
+ *   );
+ * });
+ */
+function _waitFor(f) {
+  let {
+    interval = 50,
+    stackTraceError,
+    timeout = 1500
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  const maxTries = Math.ceil(timeout / interval);
+  let tries = 0;
+  return new Promise((resolve, reject) => {
+    const rejectOrRerun = error => {
+      if (tries > maxTries) {
+        if (stackTraceError !== undefined) {
+          copyStackTrace(error, stackTraceError);
+        }
+        reject(error);
+        return;
+      }
+      originalSetTimeout(runExpectation, interval);
+    };
+    function runExpectation() {
+      tries += 1;
+      try {
+        Promise.resolve(f()).then(resolve).catch(rejectOrRerun);
+      } catch (error) {
+        // @ts-expect-error ts-migrate(2571) Object is of type 'unknown'
+        rejectOrRerun(error);
+      }
+    }
+    originalSetTimeout(runExpectation, 0);
+  });
+}
+
+/**
+ * Wraps `_waitFor` in React's `act` testing utility. Used when the React component
+ * updates during the execution of the callback (either because of indirect effects
+ * being run or because of direct requests to update the component, like wrapper.update).
+ * Prevents updates related to the callback from being affected by other updates
+ * and more closely mimics how React runs in the browser. See
+ * https://reactjs.org/docs/test-utils.html#act for more info on `act`.
+ */
+async function waitFor(callback, options) {
+  let result;
+  // See https://github.com/testing-library/dom-testing-library/blob/f7b5c33c44
+  // 632fba1579cb44f9f175be1ec46087/src/wait-for.js#L182-L184
+  const stackTraceError = new Error('STACK_TRACE_ERROR');
+  await act(async () => {
+    result = await _waitFor(callback, {
+      stackTraceError,
+      ...options
+    });
+  });
+
+  // @ts-expect-error: either `waitFor` will throw or `result` will be assigned
+  return result;
+}
+
 // eslint-disable-next-line @databricks/no-restricted-imports-regexp
 
+/**
+ * Clicks on the "Clear" button. In order for this function to work properly,
+ * the `allowClear` prop must be set to `true`.
+ */
+function clearAll(getSelect) {
+  getSelect().find(".".concat(selectClasses.clear)).hostNodes().simulate('mousedown');
+}
+
+/**
+ * Closes the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already closed or if the menu is unable to be closed.
+ */
+async function closeMenu(getSelect) {
+  if (!getSelect().find(".".concat(selectClasses.open)).exists()) {
+    throw new Error("Select is already closed\n".concat(getSelect().debug()));
+  }
+  getSelect().find(".".concat(selectClasses.selector)).simulate('mousedown');
+  await waitFor(() => {
+    const select = getSelect();
+    if (select.find(".".concat(selectClasses.open)).exists()) {
+      throw new Error("Select did not close\n".concat(select.debug()));
+    }
+  });
+}
+
+/**
+ * Returns a string concatenating the labels for all selected options.
+ */
+function getLabelText(getSelect) {
+  // Trim the text to avoid weird whitespace issues non-label elements being added.
+  // For example, the input mirror is an empty span with some whitespace that is
+  // nested under the selector but does not show up in the label text.
+  return getSelect().find(".".concat(selectClasses.selector)).text().trim();
+}
+
+/**
+ * Selects options from the dropdown menu for a <Select/> component with `mode="multiple"`.
+ * The provided strings must match the option labels exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+async function multiSelect(getSelect, options) {
+  await openMenu(getSelect);
+  options.forEach(option => {
+    findByText(getSelect().find(".".concat(selectClasses.list)), option).simulate('click');
+  });
+  // Close the menu to indicate that selection has finished
+  await closeMenu(getSelect);
+}
+
+/**
+ * Selects options from the dropdown menu for a <Select/> component without a
+ * mode. The provided string must match an option label exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+async function singleSelect(getSelect, option) {
+  await openMenu(getSelect);
+  findByText(getSelect().find(".".concat(selectClasses.list)), option).simulate('click');
+  // Menu automatically closes for a single <Select/> (no mode="multiple")
+}
+
+/**
+ * Opens the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already opened or if the menu is unable to be opened.
+ */
+async function openMenu(getSelect) {
+  if (getSelect().find(".".concat(selectClasses.open)).exists()) {
+    throw new Error("Select is already open\n".concat(getSelect().debug()));
+  }
+  getSelect().find(".".concat(selectClasses.selector)).simulate('mousedown');
+  await waitFor(() => {
+    const select = getSelect();
+    if (!select.find(".".concat(selectClasses.open)).exists()) {
+      throw new Error("Select did not open\n".concat(select.debug()));
+    }
+  });
+}
+
+/**
+ * Opens the dropdown menu, finds all of the options in the dropdown, closes
+ * the menu, and returns a list of the text of each option in order.
+ */
+async function getAllOptions(getSelect) {
+  await openMenu(getSelect);
+  const options = getSelect().find(".".concat(selectClasses.list)).find(".".concat(selectClasses.option)).map(option => option.text());
+  await closeMenu(getSelect);
+  return options;
+}
+
+var selectEvent = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  clearAll: clearAll,
+  closeMenu: closeMenu,
+  getLabelText: getLabelText,
+  multiSelect: multiSelect,
+  singleSelect: singleSelect,
+  openMenu: openMenu,
+  getAllOptions: getAllOptions
+});
+
+// eslint-disable-next-line @databricks/no-restricted-imports-regexp
 /**
  * Open a dropdown menu by simulating a pointerDown event on the dropdown button.
  *
@@ -12,5 +269,5 @@ const openDropdownMenu = dropdownButton => {
   });
 };
 
-export { openDropdownMenu };
+export { openDropdownMenu, selectEvent };
 //# sourceMappingURL=enzyme.js.map

package/dist/test-utils/enzyme.js.map

@@ -1 +1 @@
-{"version":3,"file":"enzyme.js","sources":["../../src/test-utils/enzyme/index.ts"],"sourcesContent":["// eslint-disable-next-line @databricks/no-restricted-imports-regexp\nimport type { ReactWrapper } from 'enzyme';\n\n/**\n * Open a dropdown menu by simulating a pointerDown event on the dropdown button.\n *\n * @param dropdownButton - The Dropdown Trigger button that opens the menu when clicked.\n */\nexport const openDropdownMenu = (dropdownButton: ReactWrapper) => {\n  dropdownButton.hostNodes().simulate('pointerDown', { button: 0, ctrlKey: false });\n};\n"],"names":["openDropdownMenu","dropdownButton","hostNodes","simulate","button","ctrlKey"],"mappings":"AAAA;;AAGA;AACA;AACA;AACA;AACA;MACaA,gBAAgB,GAAIC,cAA4B,IAAK;EAChEA,cAAc,CAACC,SAAS,EAAE,CAACC,QAAQ,CAAC,aAAa,EAAE;IAAEC,MAAM,EAAE,CAAC;IAAEC,OAAO,EAAE;GAAO,CAAC;AACnF;;;;"}
+{"version":3,"file":"enzyme.js","sources":["../../src/test-utils/enzyme/utils.ts","../../src/test-utils/enzyme/selectEvent.ts","../../src/test-utils/enzyme/index.ts"],"sourcesContent":["// eslint-disable-next-line @databricks/no-restricted-imports-regexp\nimport type { ReactWrapper } from 'enzyme';\nimport { act } from 'react-dom/test-utils';\n\ninterface QueryOptions {\n  /** Whether to trim the whitespace from DOM text using `String.prototype.trim` */\n  trim?: boolean;\n}\n\n/**\n * Finds a single element that contains the specified text in the wrapper. If\n * there are 0 or more than 1 element that contains the specified text, an error\n * is thrown. Returns the element in an enzyme wrapper.\n */\nexport function findByText<P, S, C>(\n  wrapper: ReactWrapper<P, S, C>,\n  text: string | RegExp,\n  queryOptions?: QueryOptions\n) {\n  const newWrappers = findAllByText<P, S, C>(wrapper, text, queryOptions);\n  if (newWrappers.length !== 1) {\n    throw new Error(\n      `Expected to find 1 node but found ${newWrappers.length} nodes for text \"${text}\".\\n${wrapper.debug()}`\n    );\n  }\n  return newWrappers[0];\n}\n\n/**\n * Finds all elements that contain the specified text. To avoid duplicate results,\n * only the parents of text nodes are returned.\n */\nexport function findAllByText<P, S, C>(\n  wrapper: ReactWrapper<P, S, C>,\n  text: string | RegExp,\n  { trim = false }: QueryOptions = {}\n) {\n  const textNodes = wrapper.findWhere((n) => {\n    if (n.type() !== undefined) {\n      return false;\n    }\n\n    let nodeText = n.text();\n    if (trim) {\n      nodeText = nodeText.trim();\n    }\n\n    return typeof text === 'string' ? nodeText === text : text.test(nodeText);\n  });\n  const newWrappers = textNodes.map((n) => {\n    const textNodeParent = n.parents().first();\n    if (textNodeParent.name() === 'FormattedMessage') {\n      // Try not to return FormattedMessage since it breaks `simulate` due to a bug in `enzyme-adapter-react-17`\n      // Similar to https://github.com/wojtekmaj/enzyme-adapter-react-17/issues/45\n      const formattedMessageParents = textNodeParent.parents();\n      return formattedMessageParents.length > 0 ? formattedMessageParents.first() : textNodeParent;\n    } else {\n      return textNodeParent;\n    }\n  });\n  return newWrappers;\n}\n\n// We need to keep ref to original setTimeout to avoid SinonJS fake timers if enabled\nconst originalSetTimeout = window.setTimeout;\n\n/**\n * This is so the stack trace the developer sees is one that's\n * closer to their code (because async stack traces are hard to follow).\n *\n * The code is taken from\n * https://github.com/testing-library/dom-testing-library/blob/f7b5c33c44632fba\n * 1579cb44f9f175be1ec46087/src/wait-for.js#L15-L19\n */\nfunction copyStackTrace(target: Error, source: Error) {\n  // eslint-disable-next-line no-param-reassign\n  target.stack = source.stack!.replace(source.message, target.message);\n}\n\ninterface WaitForOptions {\n  interval?: number;\n  stackTraceError?: Error;\n  timeout?: number;\n}\n\n/**\n * Run an expectation until it succeeds or reaches the timeout. The timeout of 1500ms\n * is chosen to be under the default Karma test timeout of 2000ms. This function will\n * not work properly if fake timers are being used (since it expects the real setTimeout).\n *\n * The code is taken from\n * https://github.com/TheBrainFamily/wait-for-expect/blob/master/src/index.ts,\n * with slight modifications to support Karma (instead of Jest).\n *\n *\n * Example\n * The <App /> component does not render the header synchronously.\n * Therefore, we cannot check that the wrapper's text is equal to the string\n * immediately--this assertion will fail and cause the test to fail. To\n * remediate this issue, we can run the expectation until it succeeds:\n *\n * function App() {\n *   const [value, setValue] = useState(null);\n *   useEffect(() => {\n *     const timeoutId = setTimeout(() => setValue(\"some value\"), 100);\n *     return () => clearTimeout(timeoutId);\n *   }, []);\n *   return value === null ? null : <h1>The value is: {value}</h1>;\n * }\n *\n * it('renders value', async () => {\n *   const wrapper = mount(<App />);\n *   await waitFor(() =>\n *     wrapper.update();\n *     expect(wrapper.text()).to.equal(\"The value is: some value\")\n *   );\n * });\n */\nfunction _waitFor<T>(\n  f: () => T | Promise<T>,\n  { interval = 50, stackTraceError, timeout = 1500 }: WaitForOptions = {}\n): Promise<T> {\n  const maxTries = Math.ceil(timeout / interval);\n  let tries = 0;\n  return new Promise((resolve, reject) => {\n    const rejectOrRerun = (error: Error) => {\n      if (tries > maxTries) {\n        if (stackTraceError !== undefined) {\n          copyStackTrace(error, stackTraceError);\n        }\n        reject(error);\n        return;\n      }\n      originalSetTimeout(runExpectation, interval);\n    };\n\n    function runExpectation() {\n      tries += 1;\n      try {\n        Promise.resolve(f()).then(resolve).catch(rejectOrRerun);\n      } catch (error) {\n        // @ts-expect-error ts-migrate(2571) Object is of type 'unknown'\n        rejectOrRerun(error);\n      }\n    }\n\n    originalSetTimeout(runExpectation, 0);\n  });\n}\n\n/**\n * Wraps `_waitFor` in React's `act` testing utility. Used when the React component\n * updates during the execution of the callback (either because of indirect effects\n * being run or because of direct requests to update the component, like wrapper.update).\n * Prevents updates related to the callback from being affected by other updates\n * and more closely mimics how React runs in the browser. See\n * https://reactjs.org/docs/test-utils.html#act for more info on `act`.\n */\nexport async function waitFor<T>(callback: () => T | Promise<T>, options?: WaitForOptions): Promise<T> {\n  let result: T | Promise<T>;\n  // See https://github.com/testing-library/dom-testing-library/blob/f7b5c33c44\n  // 632fba1579cb44f9f175be1ec46087/src/wait-for.js#L182-L184\n  const stackTraceError = new Error('STACK_TRACE_ERROR');\n\n  await act(async () => {\n    result = await _waitFor(callback, { stackTraceError, ...options });\n  });\n\n  // @ts-expect-error: either `waitFor` will throw or `result` will be assigned\n  return result;\n}\n","// eslint-disable-next-line @databricks/no-restricted-imports-regexp\nimport type { ReactWrapper } from 'enzyme';\n\nimport { selectClasses } from '../common';\nimport { findByText, waitFor } from './utils';\n\n/**\n * Clicks on the \"Clear\" button. In order for this function to work properly,\n * the `allowClear` prop must be set to `true`.\n */\nexport function clearAll(getSelect: () => ReactWrapper): void {\n  getSelect().find(`.${selectClasses.clear}`).hostNodes().simulate('mousedown');\n}\n\n/**\n * Closes the dropdown menu for the <Select/> by clicking. Will throw an error if\n * the menu is already closed or if the menu is unable to be closed.\n */\nexport async function closeMenu(getSelect: () => ReactWrapper): Promise<void> {\n  if (!getSelect().find(`.${selectClasses.open}`).exists()) {\n    throw new Error(`Select is already closed\\n${getSelect().debug()}`);\n  }\n  getSelect().find(`.${selectClasses.selector}`).simulate('mousedown');\n  await waitFor(() => {\n    const select = getSelect();\n    if (select.find(`.${selectClasses.open}`).exists()) {\n      throw new Error(`Select did not close\\n${select.debug()}`);\n    }\n  });\n}\n\n/**\n * Returns a string concatenating the labels for all selected options.\n */\nexport function getLabelText(getSelect: () => ReactWrapper): string {\n  // Trim the text to avoid weird whitespace issues non-label elements being added.\n  // For example, the input mirror is an empty span with some whitespace that is\n  // nested under the selector but does not show up in the label text.\n  return getSelect().find(`.${selectClasses.selector}`).text().trim();\n}\n\n/**\n * Selects options from the dropdown menu for a <Select/> component with `mode=\"multiple\"`.\n * The provided strings must match the option labels exactly. There is a known\n * limitation for lists that are extremely long because AntD virtualizes the\n * options so not all may options may be rendered in the DOM. If this is causing\n * you issues, please let #help-frontend know.\n */\nexport async function multiSelect(getSelect: () => ReactWrapper, options: string[]): Promise<void> {\n  await openMenu(getSelect);\n  options.forEach((option) => {\n    findByText(getSelect().find(`.${selectClasses.list}`), option).simulate('click');\n  });\n  // Close the menu to indicate that selection has finished\n  await closeMenu(getSelect);\n}\n\n/**\n * Selects options from the dropdown menu for a <Select/> component without a\n * mode. The provided string must match an option label exactly. There is a known\n * limitation for lists that are extremely long because AntD virtualizes the\n * options so not all may options may be rendered in the DOM. If this is causing\n * you issues, please let #help-frontend know.\n */\nexport async function singleSelect(getSelect: () => ReactWrapper, option: string): Promise<void> {\n  await openMenu(getSelect);\n  findByText(getSelect().find(`.${selectClasses.list}`), option).simulate('click');\n  // Menu automatically closes for a single <Select/> (no mode=\"multiple\")\n}\n\n/**\n * Opens the dropdown menu for the <Select/> by clicking. Will throw an error if\n * the menu is already opened or if the menu is unable to be opened.\n */\nexport async function openMenu(getSelect: () => ReactWrapper): Promise<void> {\n  if (getSelect().find(`.${selectClasses.open}`).exists()) {\n    throw new Error(`Select is already open\\n${getSelect().debug()}`);\n  }\n  getSelect().find(`.${selectClasses.selector}`).simulate('mousedown');\n  await waitFor(() => {\n    const select = getSelect();\n    if (!select.find(`.${selectClasses.open}`).exists()) {\n      throw new Error(`Select did not open\\n${select.debug()}`);\n    }\n  });\n}\n\n/**\n * Opens the dropdown menu, finds all of the options in the dropdown, closes\n * the menu, and returns a list of the text of each option in order.\n */\nexport async function getAllOptions(getSelect: () => ReactWrapper): Promise<string[]> {\n  await openMenu(getSelect);\n  const options = getSelect()\n    .find(`.${selectClasses.list}`)\n    .find(`.${selectClasses.option}`)\n    .map((option) => option.text());\n  await closeMenu(getSelect);\n  return options;\n}\n","// eslint-disable-next-line @databricks/no-restricted-imports-regexp\nimport type { ReactWrapper } from 'enzyme';\n\nexport * as selectEvent from './selectEvent';\n\n/**\n * Open a dropdown menu by simulating a pointerDown event on the dropdown button.\n *\n * @param dropdownButton - The Dropdown Trigger button that opens the menu when clicked.\n */\nexport const openDropdownMenu = (dropdownButton: ReactWrapper) => {\n  dropdownButton.hostNodes().simulate('pointerDown', { button: 0, ctrlKey: false });\n};\n"],"names":["findByText","wrapper","text","queryOptions","newWrappers","findAllByText","length","Error","debug","trim","textNodes","findWhere","n","type","undefined","nodeText","test","map","textNodeParent","parents","first","name","formattedMessageParents","originalSetTimeout","window","setTimeout","copyStackTrace","target","source","stack","replace","message","_waitFor","f","interval","stackTraceError","timeout","maxTries","Math","ceil","tries","Promise","resolve","reject","rejectOrRerun","error","runExpectation","then","catch","waitFor","callback","options","result","act","clearAll","getSelect","find","selectClasses","clear","hostNodes","simulate","closeMenu","open","exists","selector","select","getLabelText","multiSelect","openMenu","forEach","option","list","singleSelect","getAllOptions","openDropdownMenu","dropdownButton","button","ctrlKey"],"mappings":"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"}

package/dist/test-utils/rtl/index.d.ts

@@ -1,3 +1,4 @@
+export * as selectEvent from './selectEvent';
 /**
  * Opens the dropdown menu by clicking on the dropdown button.
  *

package/dist/test-utils/rtl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test-utils/rtl/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,mBAA0B,WAAW,kBAEjE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test-utils/rtl/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,mBAA0B,WAAW,kBAEjE,CAAC"}

package/dist/test-utils/rtl/selectEvent.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Opens the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already opened or if the menu is unable to be opened.
+ */
+export declare function openMenu(select: HTMLElement): Promise<void>;
+/**
+ * Closes the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already closed or if the menu is unable to be closed.
+ */
+export declare function closeMenu(select: HTMLElement): Promise<void>;
+/**
+ * Returns a string concatenating the labels for all selected options.
+ */
+export declare function getLabelText(select: HTMLElement): string;
+/**
+ * Selects options from the dropdown menu for a <Select/> component with `mode="multiple"`.
+ * The provided strings must match the option labels exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+export declare function multiSelect(select: HTMLElement, options: string[]): Promise<void>;
+/**
+ * Selects options from the dropdown menu for a <Select/> component without a
+ * mode. The provided string must match an option label exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+export declare function singleSelect(select: HTMLElement, option: string): Promise<void>;
+/**
+ * Clicks on the "Clear" button. In order for this function to work properly,
+ * the `allowClear` prop must be set to `true`.
+ */
+export declare function clearAll(select: HTMLElement): Promise<void>;
+/**
+ * Opens the dropdown menu, finds all of the options in the dropdown, closes
+ * the menu, and returns a list of the text of each option in order.
+ */
+export declare function getAllOptions(select: HTMLElement): Promise<string[]>;
+//# sourceMappingURL=selectEvent.d.ts.map

package/dist/test-utils/rtl/selectEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectEvent.d.ts","sourceRoot":"","sources":["../../../src/test-utils/rtl/selectEvent.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CASxD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAe1E"}

package/dist/test-utils/rtl/selectEvent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selectEvent.test.d.ts.map

package/dist/test-utils/rtl/selectEvent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectEvent.test.d.ts","sourceRoot":"","sources":["../../../src/test-utils/rtl/selectEvent.test.tsx"],"names":[],"mappings":""}

package/dist/test-utils/rtl.js

@@ -1,4 +1,138 @@
 import userEvent from '@testing-library/user-event';
+import { waitFor, screen } from '@testing-library/react';
+import { expect } from '@databricks/config-jest';
+import { s as selectClasses } from '../common-3ab0e300.js';
+
+/**
+ * Opens the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already opened or if the menu is unable to be opened.
+ */
+async function openMenu(select) {
+  expect(select).not.toHaveClass(selectClasses.open);
+  const selector = select.querySelector(".".concat(selectClasses.selector));
+  if (!selector) {
+    throw new Error("Selector not found\n".concat(select.innerHTML));
+  }
+  await userEvent.click(selector, {
+    pointerEventsCheck: 0
+  });
+  await waitFor(() => {
+    expect(select).toHaveClass(selectClasses.open);
+  });
+}
+
+/**
+ * Closes the dropdown menu for the <Select/> by clicking. Will throw an error if
+ * the menu is already closed or if the menu is unable to be closed.
+ */
+async function closeMenu(select) {
+  expect(select).toHaveClass(selectClasses.open);
+  const selector = select.querySelector(".".concat(selectClasses.selector));
+  if (!selector) {
+    throw new Error("Selector not found\n".concat(select.innerHTML));
+  }
+  await userEvent.click(selector, {
+    pointerEventsCheck: 0
+  });
+  await waitFor(() => {
+    expect(select).not.toHaveClass(selectClasses.open);
+  });
+}
+
+/**
+ * Returns a string concatenating the labels for all selected options.
+ */
+function getLabelText(select) {
+  var _selector$textContent, _selector$textContent2;
+  const selector = select.querySelector(".".concat(selectClasses.selector));
+  if (!selector) {
+    throw new Error("Selector not found\n".concat(select.innerHTML));
+  }
+  // Trim the text to avoid weird whitespace issues non-label elements being added.
+  // For example, the input mirror is an empty span with some whitespace that is
+  // nested under the selector but does not show up in the label text.
+  return (_selector$textContent = (_selector$textContent2 = selector.textContent) === null || _selector$textContent2 === void 0 ? void 0 : _selector$textContent2.trim()) !== null && _selector$textContent !== void 0 ? _selector$textContent : '';
+}
+
+/**
+ * Selects options from the dropdown menu for a <Select/> component with `mode="multiple"`.
+ * The provided strings must match the option labels exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+async function multiSelect(select, options) {
+  await openMenu(select);
+  for (let i = 0; i < options.length; i++) {
+    const option = options[i];
+    const optionItem = screen.getByTitle(option);
+    await userEvent.click(optionItem, {
+      pointerEventsCheck: 0
+    });
+  }
+  // Close the menu to indicate that selection has finished
+  await closeMenu(select);
+}
+
+/**
+ * Selects options from the dropdown menu for a <Select/> component without a
+ * mode. The provided string must match an option label exactly. There is a known
+ * limitation for lists that are extremely long because AntD virtualizes the
+ * options so not all may options may be rendered in the DOM. If this is causing
+ * you issues, please let #help-frontend know.
+ */
+async function singleSelect(select, option) {
+  await openMenu(select);
+  const optionElem = screen.getByTitle(option);
+  await userEvent.click(optionElem, {
+    pointerEventsCheck: 0
+  });
+  // Menu automatically closes for a single <Select/> (no mode="multiple")
+}
+
+/**
+ * Clicks on the "Clear" button. In order for this function to work properly,
+ * the `allowClear` prop must be set to `true`.
+ */
+async function clearAll(select) {
+  const clearBtn = select.querySelector(".".concat(selectClasses.clear));
+  if (!clearBtn) {
+    throw new Error("Select not clearable\n".concat(select.innerHTML));
+  }
+  await userEvent.click(clearBtn);
+}
+
+/**
+ * Opens the dropdown menu, finds all of the options in the dropdown, closes
+ * the menu, and returns a list of the text of each option in order.
+ */
+async function getAllOptions(select) {
+  await openMenu(select);
+  const optionsList = select.ownerDocument.body.querySelector(".".concat(selectClasses.list));
+  if (optionsList === null) {
+    throw new Error("Options list not found\n".concat(select.ownerDocument.body.innerHTML));
+  }
+  const options = [];
+  optionsList.querySelectorAll(".".concat(selectClasses.option)).forEach(option => {
+    if (option.textContent === null) {
+      throw new Error("Option had no text content\n".concat(option.innerHTML));
+    }
+    options.push(option.textContent);
+  });
+  await closeMenu(select);
+  return options;
+}
+
+var selectEvent = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  openMenu: openMenu,
+  closeMenu: closeMenu,
+  getLabelText: getLabelText,
+  multiSelect: multiSelect,
+  singleSelect: singleSelect,
+  clearAll: clearAll,
+  getAllOptions: getAllOptions
+});
 
 /**
  * Opens the dropdown menu by clicking on the dropdown button.
@@ -9,5 +143,5 @@ const openDropdownMenu = async dropdownButton => {
   await userEvent.click(dropdownButton);
 };
 
-export { openDropdownMenu };
+export { openDropdownMenu, selectEvent };
 //# sourceMappingURL=rtl.js.map