@react-aria/test-utils 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/select.module.js

@@ -1,4 +1,4 @@
-import {within as $7v0pZ$within, act as $7v0pZ$act, waitFor as $7v0pZ$waitFor} from "@testing-library/react";
+import {act as $7v0pZ$act, waitFor as $7v0pZ$waitFor, within as $7v0pZ$within} from "@testing-library/react";
 
 /*
  * Copyright 2024 Adobe. All rights reserved.
@@ -12,87 +12,133 @@ import {within as $7v0pZ$within, act as $7v0pZ$act, waitFor as $7v0pZ$waitFor} f
  * governing permissions and limitations under the License.
  */ 
 class $4350df3e19e40e36$export$d1859707465446a9 {
-    get trigger() {
-        return this._trigger;
+    /**
+   * Set the interaction type used by the select tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
     }
-    get listbox() {
-        let listBoxId = this.trigger.getAttribute('aria-controls');
-        return listBoxId ? document.getElementById(listBoxId) : undefined;
+    /**
+   * Opens the select. Defaults to using the interaction type set on the select tester.
+   */ async open(opts = {}) {
+        let { interactionType: interactionType = this._interactionType } = opts;
+        let trigger = this.trigger;
+        let isDisabled = trigger.hasAttribute('disabled');
+        if (interactionType === 'mouse') await this.user.click(this._trigger);
+        else if (interactionType === 'keyboard') {
+            (0, $7v0pZ$act)(()=>trigger.focus());
+            await this.user.keyboard('[Enter]');
+        } else if (interactionType === 'touch') await this.user.pointer({
+            target: this._trigger,
+            keys: '[TouchA]'
+        });
+        await (0, $7v0pZ$waitFor)(()=>{
+            if (!isDisabled && trigger.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on select element trigger.');
+            else return true;
+        });
+        let listBoxId = trigger.getAttribute('aria-controls');
+        await (0, $7v0pZ$waitFor)(()=>{
+            if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) throw new Error(`ListBox with id of ${listBoxId} not found in document.`);
+            else return true;
+        });
     }
-    get options() {
+    /**
+   * Closes the select.
+   */ async close() {
         let listbox = this.listbox;
-        return listbox ? (0, $7v0pZ$within)(listbox).queryAllByRole('option') : [];
+        if (listbox) {
+            (0, $7v0pZ$act)(()=>listbox.focus());
+            await this.user.keyboard('[Escape]');
+        }
+        await (0, $7v0pZ$waitFor)(()=>{
+            if (document.activeElement !== this._trigger) throw new Error(`Expected the document.activeElement after closing the select dropdown to be the select component trigger but got ${document.activeElement}`);
+            else return true;
+        });
+        if (listbox && document.contains(listbox)) throw new Error('Expected the select element listbox to not be in the document after closing the dropdown.');
     }
-    get sections() {
+    /**
+   * Returns a option matching the specified index or text content.
+   */ findOption(opts) {
+        let { optionIndexOrText: optionIndexOrText } = opts;
+        let option;
+        let options = this.options();
         let listbox = this.listbox;
-        return listbox ? (0, $7v0pZ$within)(listbox).queryAllByRole('group') : [];
+        if (typeof optionIndexOrText === 'number') option = options[optionIndexOrText];
+        else if (typeof optionIndexOrText === 'string' && listbox != null) option = (0, $7v0pZ$within)(listbox).getByText(optionIndexOrText).closest('[role=option]');
+        return option;
     }
-    constructor(opts){
-        this.setInteractionType = (type)=>{
-            this._interactionType = type;
-        };
-        this.open = async (opts = {})=>{
-            let { interactionType: interactionType = this._interactionType } = opts;
-            let trigger = this.trigger;
-            let isDisabled = trigger.hasAttribute('disabled');
-            if (interactionType === 'mouse') await this.user.click(this._trigger);
-            else if (interactionType === 'keyboard') {
-                (0, $7v0pZ$act)(()=>trigger.focus());
+    async keyboardNavigateToOption(opts) {
+        let { option: option } = opts;
+        let options = this.options();
+        let targetIndex = options.indexOf(option);
+        if (targetIndex === -1) throw new Error('Option provided is not in the listbox');
+        if (document.activeElement === this.listbox) await this.user.keyboard('[ArrowDown]');
+        let currIndex = options.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('ActiveElement is not in the listbox');
+        let direction = targetIndex > currIndex ? 'down' : 'up';
+        for(let i = 0; i < Math.abs(targetIndex - currIndex); i++)await this.user.keyboard(`[${direction === 'down' ? 'ArrowDown' : 'ArrowUp'}]`);
+    }
+    /**
+   * Selects the desired select option. Defaults to using the interaction type set on the select tester. If necessary, will open the select dropdown beforehand.
+   * The desired option can be targeted via the option's node, the option's text, or the option's index.
+   */ async selectOption(opts) {
+        let { option: option, interactionType: interactionType = this._interactionType } = opts || {};
+        let trigger = this.trigger;
+        if (!trigger.getAttribute('aria-controls')) await this.open();
+        let listbox = this.listbox;
+        if (!listbox) throw new Error('Select\'s listbox not found.');
+        if (listbox) {
+            if (typeof option === 'string' || typeof option === 'number') option = this.findOption({
+                optionIndexOrText: option
+            });
+            if (!option) throw new Error('Target option not found in the listbox.');
+            if (interactionType === 'keyboard') {
+                if ((option === null || option === void 0 ? void 0 : option.getAttribute('aria-disabled')) === 'true') return;
+                if (document.activeElement !== listbox || !listbox.contains(document.activeElement)) (0, $7v0pZ$act)(()=>listbox.focus());
+                await this.keyboardNavigateToOption({
+                    option: option
+                });
                 await this.user.keyboard('[Enter]');
-            } else if (interactionType === 'touch') await this.user.pointer({
-                target: this._trigger,
+            } else // TODO: what if the user needs to scroll the list to find the option? What if there are multiple matches for text (hopefully the picker options are pretty unique)
+            if (interactionType === 'mouse') await this.user.click(option);
+            else await this.user.pointer({
+                target: option,
                 keys: '[TouchA]'
             });
-            await (0, $7v0pZ$waitFor)(()=>{
-                if (!isDisabled && trigger.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on select element trigger.');
-                else return true;
-            });
-            let listBoxId = trigger.getAttribute('aria-controls');
-            await (0, $7v0pZ$waitFor)(()=>{
-                if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) throw new Error(`ListBox with id of ${listBoxId} not found in document.`);
-                else return true;
-            });
-        };
-        this.selectOption = async (opts)=>{
-            let { optionText: optionText, interactionType: interactionType = this._interactionType } = opts || {};
-            let trigger = this.trigger;
-            if (!trigger.getAttribute('aria-controls')) await this.open();
-            let listbox = this.listbox;
-            if (listbox) {
-                let option = (0, $7v0pZ$within)(listbox).getByText(optionText);
-                if (interactionType === 'keyboard') {
-                    if (document.activeElement !== listbox || !listbox.contains(document.activeElement)) (0, $7v0pZ$act)(()=>listbox.focus());
-                    // TODO: this simulates typeahead, do we want to add a helper util for that? Not sure if users would really need that for
-                    // their test
-                    await this.user.keyboard(optionText);
-                    await this.user.keyboard('[Enter]');
-                } else // TODO: what if the user needs to scroll the list to find the option? What if there are multiple matches for text (hopefully the picker options are pretty unique)
-                if (interactionType === 'mouse') await this.user.click(option);
-                else await this.user.pointer({
-                    target: option,
-                    keys: '[TouchA]'
+            if ((option === null || option === void 0 ? void 0 : option.getAttribute('href')) == null) {
+                await (0, $7v0pZ$waitFor)(()=>{
+                    if (document.activeElement !== this._trigger) throw new Error(`Expected the document.activeElement after selecting an option to be the select component trigger but got ${document.activeElement}`);
+                    else return true;
                 });
-                if (option.getAttribute('href') == null) {
-                    await (0, $7v0pZ$waitFor)(()=>{
-                        if (document.activeElement !== this._trigger) throw new Error(`Expected the document.activeElement after selecting an option to be the select component trigger but got ${document.activeElement}`);
-                        else return true;
-                    });
-                    if (document.contains(listbox)) throw new Error('Expected select element listbox to not be in the document after selecting an option');
-                }
-            }
-        };
-        this.close = async ()=>{
-            let listbox = this.listbox;
-            if (listbox) {
-                (0, $7v0pZ$act)(()=>listbox.focus());
-                await this.user.keyboard('[Escape]');
+                if (document.contains(listbox)) throw new Error('Expected select element listbox to not be in the document after selecting an option');
             }
-            await (0, $7v0pZ$waitFor)(()=>{
-                if (document.activeElement !== this._trigger) throw new Error(`Expected the document.activeElement after closing the select dropdown to be the select component trigger but got ${document.activeElement}`);
-                else return true;
-            });
-            if (listbox && document.contains(listbox)) throw new Error('Expected the select element listbox to not be in the document after closing the dropdown.');
-        };
+        }
+    }
+    /**
+   * Returns the select's options if present. Can be filtered to a subsection of the listbox if provided via `element`.
+   */ options(opts = {}) {
+        let { element: element = this.listbox } = opts;
+        let options = [];
+        if (element) options = (0, $7v0pZ$within)(element).queryAllByRole('option');
+        return options;
+    }
+    /**
+   * Returns the select's trigger.
+   */ get trigger() {
+        return this._trigger;
+    }
+    /**
+   * Returns the select's listbox if present.
+   */ get listbox() {
+        let listBoxId = this.trigger.getAttribute('aria-controls');
+        return listBoxId ? document.getElementById(listBoxId) : null;
+    }
+    /**
+   * Returns the select's sections if present.
+   */ get sections() {
+        let listbox = this.listbox;
+        return listbox ? (0, $7v0pZ$within)(listbox).queryAllByRole('group') : [];
+    }
+    constructor(opts){
         let { root: root, user: user, interactionType: interactionType } = opts;
         this.user = user;
         this._interactionType = interactionType || 'mouse';

package/dist/select.module.js.map

@@ -1 +1 @@
-{"mappings":"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","sources":["packages/@react-aria/test-utils/src/select.ts"],"sourcesContent":["/*\n * Copyright 2024 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {act, waitFor, within} from '@testing-library/react';\nimport {BaseTesterOpts, UserOpts} from './user';\n\nexport interface SelectOptions extends UserOpts, BaseTesterOpts {\n  // TODO: I think the type grabbed from the testing library dist for UserEvent is breaking the build, will need to figure out a better place to grab from\n  user?: any\n}\nexport class SelectTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _trigger: HTMLElement;\n\n  constructor(opts: SelectOptions) {\n    let {root, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n    // Handle case where the wrapper element is provided rather than the Select's button (aka RAC)\n    let triggerButton = within(root).queryByRole('button');\n    if (triggerButton == null) {\n      triggerButton = root;\n    }\n    this._trigger = triggerButton;\n  }\n\n  setInteractionType = (type: UserOpts['interactionType']) => {\n    this._interactionType = type;\n  };\n\n  open = async (opts: {interactionType?: UserOpts['interactionType']} = {}) => {\n    let {\n      interactionType = this._interactionType\n    } = opts;\n    let trigger = this.trigger;\n    let isDisabled = trigger.hasAttribute('disabled');\n\n    if (interactionType === 'mouse') {\n      await this.user.click(this._trigger);\n    } else if (interactionType === 'keyboard') {\n      act(() => trigger.focus());\n      await this.user.keyboard('[Enter]');\n    } else if (interactionType === 'touch') {\n      await this.user.pointer({target: this._trigger, keys: '[TouchA]'});\n    }\n\n    await waitFor(() => {\n      if (!isDisabled && trigger.getAttribute('aria-controls') == null) {\n        throw new Error('No aria-controls found on select element trigger.');\n      } else {\n        return true;\n      }\n    });\n    let listBoxId = trigger.getAttribute('aria-controls');\n    await waitFor(() => {\n      if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) {\n        throw new Error(`ListBox with id of ${listBoxId} not found in document.`);\n      } else {\n        return true;\n      }\n    });\n  };\n\n  selectOption = async (opts: {optionText: string, interactionType?: UserOpts['interactionType']}) => {\n    let {\n      optionText,\n      interactionType = this._interactionType\n    } = opts || {};\n    let trigger = this.trigger;\n    if (!trigger.getAttribute('aria-controls')) {\n      await this.open();\n    }\n    let listbox = this.listbox;\n    if (listbox) {\n      let option = within(listbox).getByText(optionText);\n      if (interactionType === 'keyboard') {\n        if (document.activeElement !== listbox || !listbox.contains(document.activeElement)) {\n          act(() => listbox.focus());\n        }\n\n        // TODO: this simulates typeahead, do we want to add a helper util for that? Not sure if users would really need that for\n        // their test\n        await this.user.keyboard(optionText);\n        await this.user.keyboard('[Enter]');\n      } else {\n        // TODO: what if the user needs to scroll the list to find the option? What if there are multiple matches for text (hopefully the picker options are pretty unique)\n        if (interactionType === 'mouse') {\n          await this.user.click(option);\n        } else {\n          await this.user.pointer({target: option, keys: '[TouchA]'});\n        }\n      }\n\n      if (option.getAttribute('href') == null) {\n        await waitFor(() => {\n          if (document.activeElement !== this._trigger) {\n            throw new Error(`Expected the document.activeElement after selecting an option to be the select component trigger but got ${document.activeElement}`);\n          } else {\n            return true;\n          }\n        });\n\n        if (document.contains(listbox)) {\n          throw new Error('Expected select element listbox to not be in the document after selecting an option');\n        }\n      }\n    }\n  };\n\n  close = async () => {\n    let listbox = this.listbox;\n    if (listbox) {\n      act(() => listbox.focus());\n      await this.user.keyboard('[Escape]');\n    }\n\n    await waitFor(() => {\n      if (document.activeElement !== this._trigger) {\n        throw new Error(`Expected the document.activeElement after closing the select dropdown to be the select component trigger but got ${document.activeElement}`);\n      } else {\n        return true;\n      }\n    });\n\n    if (listbox && document.contains(listbox)) {\n      throw new Error('Expected the select element listbox to not be in the document after closing the dropdown.');\n    }\n  };\n\n  get trigger() {\n    return this._trigger;\n  }\n\n  get listbox() {\n    let listBoxId = this.trigger.getAttribute('aria-controls');\n    return listBoxId ? document.getElementById(listBoxId) : undefined;\n  }\n\n  get options() {\n    let listbox = this.listbox;\n    return listbox ? within(listbox).queryAllByRole('option') : [];\n  }\n\n  get sections() {\n    let listbox = this.listbox;\n    return listbox ? within(listbox).queryAllByRole('group') : [];\n  }\n}\n"],"names":[],"version":3,"file":"select.module.js.map"}
+{"mappings":"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","sources":["packages/@react-aria/test-utils/src/select.ts"],"sourcesContent":["/*\n * Copyright 2024 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {act, waitFor, within} from '@testing-library/react';\nimport {SelectTesterOpts, UserOpts} from './types';\n\ninterface SelectOpenOpts {\n  /**\n   * What interaction type to use when opening the select. Defaults to the interaction type set on the tester.\n   */\n  interactionType?: UserOpts['interactionType']\n}\n\ninterface SelectTriggerOptionOpts extends SelectOpenOpts {\n  /**\n   * The index, text, or node of the option to select. Option nodes can be sourced via `options()`.\n   */\n  option: number | string | HTMLElement\n}\n\nexport class SelectTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _trigger: HTMLElement;\n\n  constructor(opts: SelectTesterOpts) {\n    let {root, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n    // Handle case where the wrapper element is provided rather than the Select's button (aka RAC)\n    let triggerButton = within(root).queryByRole('button');\n    if (triggerButton == null) {\n      triggerButton = root;\n    }\n    this._trigger = triggerButton;\n  }\n  /**\n   * Set the interaction type used by the select tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']) {\n    this._interactionType = type;\n  }\n\n  /**\n   * Opens the select. Defaults to using the interaction type set on the select tester.\n   */\n  async open(opts: SelectOpenOpts = {}) {\n    let {\n      interactionType = this._interactionType\n    } = opts;\n    let trigger = this.trigger;\n    let isDisabled = trigger.hasAttribute('disabled');\n\n    if (interactionType === 'mouse') {\n      await this.user.click(this._trigger);\n    } else if (interactionType === 'keyboard') {\n      act(() => trigger.focus());\n      await this.user.keyboard('[Enter]');\n    } else if (interactionType === 'touch') {\n      await this.user.pointer({target: this._trigger, keys: '[TouchA]'});\n    }\n\n    await waitFor(() => {\n      if (!isDisabled && trigger.getAttribute('aria-controls') == null) {\n        throw new Error('No aria-controls found on select element trigger.');\n      } else {\n        return true;\n      }\n    });\n    let listBoxId = trigger.getAttribute('aria-controls');\n    await waitFor(() => {\n      if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) {\n        throw new Error(`ListBox with id of ${listBoxId} not found in document.`);\n      } else {\n        return true;\n      }\n    });\n  }\n\n  /**\n   * Closes the select.\n   */\n  async close() {\n    let listbox = this.listbox;\n    if (listbox) {\n      act(() => listbox.focus());\n      await this.user.keyboard('[Escape]');\n    }\n\n    await waitFor(() => {\n      if (document.activeElement !== this._trigger) {\n        throw new Error(`Expected the document.activeElement after closing the select dropdown to be the select component trigger but got ${document.activeElement}`);\n      } else {\n        return true;\n      }\n    });\n\n    if (listbox && document.contains(listbox)) {\n      throw new Error('Expected the select element listbox to not be in the document after closing the dropdown.');\n    }\n  }\n\n  /**\n   * Returns a option matching the specified index or text content.\n   */\n  findOption(opts: {optionIndexOrText: number | string}): HTMLElement {\n    let {\n      optionIndexOrText\n    } = opts;\n\n    let option;\n    let options = this.options();\n    let listbox = this.listbox;\n\n    if (typeof optionIndexOrText === 'number') {\n      option = options[optionIndexOrText];\n    } else if (typeof optionIndexOrText === 'string' && listbox != null) {\n      option = (within(listbox!).getByText(optionIndexOrText).closest('[role=option]'))! as HTMLElement;\n    }\n\n    return option;\n  }\n\n  private async keyboardNavigateToOption(opts: {option: HTMLElement}) {\n    let {option} = opts;\n    let options = this.options();\n    let targetIndex = options.indexOf(option);\n    if (targetIndex === -1) {\n      throw new Error('Option provided is not in the listbox');\n    }\n    if (document.activeElement === this.listbox) {\n      await this.user.keyboard('[ArrowDown]');\n    }\n    let currIndex = options.indexOf(document.activeElement as HTMLElement);\n    if (currIndex === -1) {\n      throw new Error('ActiveElement is not in the listbox');\n    }\n    let direction = targetIndex > currIndex ? 'down' : 'up';\n\n    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {\n      await this.user.keyboard(`[${direction === 'down' ? 'ArrowDown' : 'ArrowUp'}]`);\n    }\n  };\n\n  /**\n   * Selects the desired select option. Defaults to using the interaction type set on the select tester. If necessary, will open the select dropdown beforehand.\n   * The desired option can be targeted via the option's node, the option's text, or the option's index.\n   */\n  async selectOption(opts: SelectTriggerOptionOpts) {\n    let {\n      option,\n      interactionType = this._interactionType\n    } = opts || {};\n    let trigger = this.trigger;\n    if (!trigger.getAttribute('aria-controls')) {\n      await this.open();\n    }\n    let listbox = this.listbox;\n    if (!listbox) {\n      throw new Error('Select\\'s listbox not found.');\n    }\n\n    if (listbox) {\n      if (typeof option === 'string' || typeof option === 'number') {\n        option = this.findOption({optionIndexOrText: option});\n      }\n\n      if (!option) {\n        throw new Error('Target option not found in the listbox.');\n      }\n\n      if (interactionType === 'keyboard') {\n        if (option?.getAttribute('aria-disabled') === 'true') {\n          return;\n        }\n\n        if (document.activeElement !== listbox || !listbox.contains(document.activeElement)) {\n          act(() => listbox.focus());\n        }\n        await this.keyboardNavigateToOption({option});\n        await this.user.keyboard('[Enter]');\n      } else {\n        // TODO: what if the user needs to scroll the list to find the option? What if there are multiple matches for text (hopefully the picker options are pretty unique)\n        if (interactionType === 'mouse') {\n          await this.user.click(option);\n        } else {\n          await this.user.pointer({target: option, keys: '[TouchA]'});\n        }\n      }\n\n      if (option?.getAttribute('href') == null) {\n        await waitFor(() => {\n          if (document.activeElement !== this._trigger) {\n            throw new Error(`Expected the document.activeElement after selecting an option to be the select component trigger but got ${document.activeElement}`);\n          } else {\n            return true;\n          }\n        });\n\n        if (document.contains(listbox)) {\n          throw new Error('Expected select element listbox to not be in the document after selecting an option');\n        }\n      }\n    }\n  }\n\n  /**\n   * Returns the select's options if present. Can be filtered to a subsection of the listbox if provided via `element`.\n   */\n  options(opts: {element?: HTMLElement} = {}): HTMLElement[] {\n    let {element = this.listbox} = opts;\n    let options = [];\n    if (element) {\n      options = within(element).queryAllByRole('option');\n    }\n\n    return options;\n  }\n\n  /**\n   * Returns the select's trigger.\n   */\n  get trigger(): HTMLElement {\n    return this._trigger;\n  }\n\n  /**\n   * Returns the select's listbox if present.\n   */\n  get listbox(): HTMLElement | null {\n    let listBoxId = this.trigger.getAttribute('aria-controls');\n    return listBoxId ? document.getElementById(listBoxId) : null;\n  }\n\n  /**\n   * Returns the select's sections if present.\n   */\n  get sections(): HTMLElement[] {\n    let listbox = this.listbox;\n    return listbox ? within(listbox).queryAllByRole('group') : [];\n  }\n}\n"],"names":[],"version":3,"file":"select.module.js.map"}

package/dist/table.main.js

@@ -20,161 +20,188 @@ $parcel$export(module.exports, "TableTester", () => $80a9def682ac1297$export$4c6
  */ 
 
 class $80a9def682ac1297$export$4c6a9d6ae3b0086 {
-    get table() {
+    /**
+   * Set the interaction type used by the table tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Toggles the selection for the specified table row. Defaults to using the interaction type set on the table tester.
+   */ async toggleRowSelection(opts) {
+        let { row: row, needsLongPress: needsLongPress, checkboxSelection: checkboxSelection = true, interactionType: interactionType = this._interactionType } = opts;
+        if (typeof row === 'string' || typeof row === 'number') row = this.findRow({
+            rowIndexOrText: row
+        });
+        if (!row) throw new Error('Target row not found in the table.');
+        let rowCheckbox = (0, $2auAU$testinglibraryreact.within)(row).queryByRole('checkbox');
+        if (interactionType === 'keyboard' && !checkboxSelection) {
+            // TODO: for now focus the row directly until I add keyboard navigation
+            await (0, $2auAU$testinglibraryreact.act)(async ()=>{
+                row.focus();
+            });
+            await this.user.keyboard('{Space}');
+            return;
+        }
+        if (rowCheckbox && checkboxSelection) await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, rowCheckbox, interactionType);
+        else {
+            let cell = (0, $2auAU$testinglibraryreact.within)(row).getAllByRole('gridcell')[0];
+            if (needsLongPress && interactionType === 'touch') {
+                if (this._advanceTimer == null) throw new Error('No advanceTimers provided for long press.');
+                // Note that long press interactions with rows is strictly touch only for grid rows
+                await (0, $5a8bfe1663b8366d$exports.triggerLongPress)({
+                    element: cell,
+                    advanceTimer: this._advanceTimer,
+                    pointerOpts: {
+                        pointerType: 'touch'
+                    }
+                });
+            } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, cell, interactionType);
+        }
+    }
+    /**
+   * Toggles the sort order for the specified table column. Defaults to using the interaction type set on the table tester.
+   */ async toggleSort(opts) {
+        let { column: column, interactionType: interactionType = this._interactionType } = opts;
+        let columnheader;
+        if (typeof column === 'number') columnheader = this.columns[column];
+        else if (typeof column === 'string') {
+            columnheader = (0, $2auAU$testinglibraryreact.within)(this.rowGroups[0]).getByText(column);
+            while(columnheader && !/columnheader/.test(columnheader.getAttribute('role')))columnheader = columnheader.parentElement;
+        } else columnheader = column;
+        let menuButton = (0, $2auAU$testinglibraryreact.within)(columnheader).queryByRole('button');
+        if (menuButton) {
+            let currentSort = columnheader.getAttribute('aria-sort');
+            // TODO: Focus management is all kinda of messed up if I just use .focus and Space to open the sort menu. Seems like
+            // the focused key doesn't get properly set to the desired column header. Have to do this strange flow where I focus the
+            // column header except if the active element is already the menu button within the column header
+            if (interactionType === 'keyboard' && document.activeElement !== menuButton) await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, columnheader, interactionType);
+            else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, menuButton, interactionType);
+            await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
+                if (menuButton.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on table column dropdown menu trigger element.');
+                else return true;
+            });
+            let menuId = menuButton.getAttribute('aria-controls');
+            await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
+                if (!menuId || document.getElementById(menuId) == null) throw new Error(`Table column header menu with id of ${menuId} not found in document.`);
+                else return true;
+            });
+            if (menuId) {
+                let menu = document.getElementById(menuId);
+                if (menu) {
+                    if (currentSort === 'ascending') await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, (0, $2auAU$testinglibraryreact.within)(menu).getAllByRole('menuitem')[1], interactionType);
+                    else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, (0, $2auAU$testinglibraryreact.within)(menu).getAllByRole('menuitem')[0], interactionType);
+                    await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
+                        if (document.contains(menu)) throw new Error('Expected table column menu listbox to not be in the document after selecting an option');
+                        else return true;
+                    });
+                }
+            }
+            // Handle cases where the table may transition in response to the row selection/deselection
+            if (!this._advanceTimer) throw new Error('No advanceTimers provided for table transition.');
+            await (0, $2auAU$testinglibraryreact.act)(async ()=>{
+                var _this__advanceTimer, _this;
+                await ((_this__advanceTimer = (_this = this)._advanceTimer) === null || _this__advanceTimer === void 0 ? void 0 : _this__advanceTimer.call(_this, 200));
+            });
+            await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
+                if (document.activeElement !== menuButton) throw new Error(`Expected the document.activeElement to be the table column menu button but got ${document.activeElement}`);
+                else return true;
+            });
+        } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, columnheader, interactionType);
+    }
+    /**
+   * Triggers the action for the specified table row. Defaults to using the interaction type set on the table tester.
+   */ async triggerRowAction(opts) {
+        let { row: row, needsDoubleClick: needsDoubleClick, interactionType: interactionType = this._interactionType } = opts;
+        if (typeof row === 'string' || typeof row === 'number') row = this.findRow({
+            rowIndexOrText: row
+        });
+        if (!row) throw new Error('Target row not found in the table.');
+        if (needsDoubleClick) await this.user.dblClick(row);
+        else if (interactionType === 'keyboard') {
+            // TODO: add keyboard navigation instead of focusing the row directly. Will need to consider if the focus in in the columns
+            (0, $2auAU$testinglibraryreact.act)(()=>row.focus());
+            await this.user.keyboard('[Enter]');
+        } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, row, interactionType);
+    }
+    // TODO: should there be utils for drag and drop and column resizing? For column resizing, I'm not entirely convinced that users will be doing that in their tests.
+    // For DnD, it might be tricky to do for keyboard DnD since we wouldn't know what valid drop zones there are... Similarly, for simulating mouse drag and drop the coordinates depend
+    // on the mocks the user sets up for their row height/etc.
+    // Additionally, should we also support keyboard navigation/typeahead? Those felt like they could be very easily replicated by the user via user.keyboard already and don't really
+    // add much value if we provide that to them
+    /**
+   * Toggle selection for all rows in the table. Defaults to using the interaction type set on the table tester.
+   */ async toggleSelectAll(opts = {}) {
+        let { interactionType: interactionType = this._interactionType } = opts;
+        let checkbox = (0, $2auAU$testinglibraryreact.within)(this.table).getByLabelText('Select All');
+        if (interactionType === 'keyboard') // TODO: using the .focus -> trigger keyboard Enter approach doesn't work for some reason, for now just trigger select all with click.
+        await this.user.click(checkbox);
+        else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, checkbox, interactionType);
+    }
+    /**
+   * Returns a row matching the specified index or text content.
+   */ findRow(opts) {
+        let { rowIndexOrText: rowIndexOrText } = opts;
+        let row;
+        let rows = this.rows;
+        let bodyRowGroup = this.rowGroups[1];
+        if (typeof rowIndexOrText === 'number') row = rows[rowIndexOrText];
+        else if (typeof rowIndexOrText === 'string') {
+            row = (0, $2auAU$testinglibraryreact.within)(bodyRowGroup).getByText(rowIndexOrText);
+            while(row && row.getAttribute('role') !== 'row')row = row.parentElement;
+        }
+        return row;
+    }
+    /**
+   * Returns a cell matching the specified text content.
+   */ findCell(opts) {
+        let { text: text } = opts;
+        let cell = (0, $2auAU$testinglibraryreact.within)(this.table).getByText(text);
+        if (cell) while(cell && !/gridcell|rowheader|columnheader/.test(cell.getAttribute('role') || '')){
+            if (cell.parentElement) cell = cell.parentElement;
+            else break;
+        }
+        return cell;
+    }
+    /**
+   * Returns the table.
+   */ get table() {
         return this._table;
     }
-    get rowGroups() {
+    /**
+   * Returns the row groups within the table.
+   */ get rowGroups() {
         let table = this._table;
         return table ? (0, $2auAU$testinglibraryreact.within)(table).queryAllByRole('rowgroup') : [];
     }
-    get columns() {
+    /**
+   * Returns the columns within the table.
+   */ get columns() {
         let headerRowGroup = this.rowGroups[0];
         return headerRowGroup ? (0, $2auAU$testinglibraryreact.within)(headerRowGroup).queryAllByRole('columnheader') : [];
     }
-    get rows() {
+    /**
+   * Returns the rows within the table if any.
+   */ get rows() {
         let bodyRowGroup = this.rowGroups[1];
         return bodyRowGroup ? (0, $2auAU$testinglibraryreact.within)(bodyRowGroup).queryAllByRole('row') : [];
     }
-    get selectedRows() {
+    /**
+   * Returns the currently selected rows within the table if any.
+   */ get selectedRows() {
         return this.rows.filter((row)=>row.getAttribute('aria-selected') === 'true');
     }
-    get rowHeaders() {
-        let table = this.table;
-        return table ? (0, $2auAU$testinglibraryreact.within)(table).queryAllByRole('rowheader') : [];
+    /**
+   * Returns the row headers within the table if any.
+   */ get rowHeaders() {
+        return (0, $2auAU$testinglibraryreact.within)(this.table).queryAllByRole('rowheader');
     }
-    get cells() {
-        let table = this.table;
-        return table ? (0, $2auAU$testinglibraryreact.within)(table).queryAllByRole('gridcell') : [];
+    /**
+   * Returns the cells within the table if any. Can be filtered against a specific row if provided via `element`.
+   */ cells(opts = {}) {
+        let { element: element = this.table } = opts;
+        return (0, $2auAU$testinglibraryreact.within)(element).queryAllByRole('gridcell');
     }
     constructor(opts){
-        this.setInteractionType = (type)=>{
-            this._interactionType = type;
-        };
-        this.toggleRowSelection = async (opts = {})=>{
-            let { index: index, text: text, needsLongPress: needsLongPress, interactionType: interactionType = this._interactionType } = opts;
-            let row = this.findRow({
-                index: index,
-                text: text
-            });
-            let rowCheckbox = (0, $2auAU$testinglibraryreact.within)(row).queryByRole('checkbox');
-            if (rowCheckbox) await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, rowCheckbox, interactionType);
-            else {
-                let cell = (0, $2auAU$testinglibraryreact.within)(row).getAllByRole('gridcell')[0];
-                if (needsLongPress && interactionType === 'touch') {
-                    if (this._advanceTimer == null) throw new Error('No advanceTimers provided for long press.');
-                    // Note that long press interactions with rows is strictly touch only for grid rows
-                    await (0, $5a8bfe1663b8366d$exports.triggerLongPress)({
-                        element: cell,
-                        advanceTimer: this._advanceTimer,
-                        pointerOpts: {
-                            pointerType: 'touch'
-                        }
-                    });
-                    // TODO: interestingly enough, we need to do a followup click otherwise future row selections may not fire properly?
-                    // To reproduce, try removing this, forcing toggleRowSelection to hit "needsLongPress ? await triggerLongPress(cell) : await action(cell);" and
-                    // run Table.test's "should support long press to enter selection mode on touch" test to see what happens
-                    await (0, $2auAU$testinglibraryreact.fireEvent).click(cell);
-                } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, cell, interactionType);
-            }
-        };
-        this.toggleSort = async (opts = {})=>{
-            let { index: index, text: text, interactionType: interactionType = this._interactionType } = opts;
-            let columnheader;
-            if (index != null) columnheader = this.columns[index];
-            else if (text != null) {
-                columnheader = (0, $2auAU$testinglibraryreact.within)(this.rowGroups[0]).getByText(text);
-                while(columnheader && !/columnheader/.test(columnheader.getAttribute('role')))columnheader = columnheader.parentElement;
-            }
-            let menuButton = (0, $2auAU$testinglibraryreact.within)(columnheader).queryByRole('button');
-            if (menuButton) {
-                let currentSort = columnheader.getAttribute('aria-sort');
-                // TODO: Focus management is all kinda of messed up if I just use .focus and Space to open the sort menu. Seems like
-                // the focused key doesn't get properly set to the desired column header. Have to do this strange flow where I focus the
-                // column header except if the active element is already the menu button within the column header
-                if (interactionType === 'keyboard' && document.activeElement !== menuButton) await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, columnheader, interactionType);
-                else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, menuButton, interactionType);
-                await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
-                    if (menuButton.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on table column dropdown menu trigger element.');
-                    else return true;
-                });
-                let menuId = menuButton.getAttribute('aria-controls');
-                await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
-                    if (!menuId || document.getElementById(menuId) == null) throw new Error(`Table column header menu with id of ${menuId} not found in document.`);
-                    else return true;
-                });
-                if (menuId) {
-                    let menu = document.getElementById(menuId);
-                    if (menu) {
-                        if (currentSort === 'ascending') await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, (0, $2auAU$testinglibraryreact.within)(menu).getAllByRole('menuitem')[1], interactionType);
-                        else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, (0, $2auAU$testinglibraryreact.within)(menu).getAllByRole('menuitem')[0], interactionType);
-                        await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
-                            if (document.contains(menu)) throw new Error('Expected table column menu listbox to not be in the document after selecting an option');
-                            else return true;
-                        });
-                    }
-                }
-                // Handle cases where the table may transition in response to the row selection/deselection
-                if (!this._advanceTimer) throw new Error('No advanceTimers provided for table transition.');
-                await (0, $2auAU$testinglibraryreact.act)(async ()=>{
-                    var _this__advanceTimer, _this;
-                    await ((_this__advanceTimer = (_this = this)._advanceTimer) === null || _this__advanceTimer === void 0 ? void 0 : _this__advanceTimer.call(_this, 200));
-                });
-                await (0, $2auAU$testinglibraryreact.waitFor)(()=>{
-                    if (document.activeElement !== menuButton) throw new Error(`Expected the document.activeElement to be the table column menu button but got ${document.activeElement}`);
-                    else return true;
-                });
-            } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, columnheader, interactionType);
-        };
-        // TODO: should there be a util for triggering a row action? Perhaps there should be but it would rely on the user teling us the config of the
-        // table. Maybe we could rely on the user knowing to trigger a press/double click? We could have the user pass in "needsDoubleClick"
-        // It is also iffy if there is any row selected because then the table is in selectionMode and the below actions will simply toggle row selection
-        this.triggerRowAction = async (opts = {})=>{
-            let { index: index, text: text, needsDoubleClick: needsDoubleClick, interactionType: interactionType = this._interactionType } = opts;
-            let row = this.findRow({
-                index: index,
-                text: text
-            });
-            if (row) {
-                if (needsDoubleClick) await this.user.dblClick(row);
-                else if (interactionType === 'keyboard') {
-                    (0, $2auAU$testinglibraryreact.act)(()=>row.focus());
-                    await this.user.keyboard('[Enter]');
-                } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, row, interactionType);
-            }
-        };
-        // TODO: should there be utils for drag and drop and column resizing? For column resizing, I'm not entirely convinced that users will be doing that in their tests.
-        // For DnD, it might be tricky to do for keyboard DnD since we wouldn't know what valid drop zones there are... Similarly, for simulating mouse drag and drop the coordinates depend
-        // on the mocks the user sets up for their row height/etc.
-        // Additionally, should we also support keyboard navigation/typeahead? Those felt like they could be very easily replicated by the user via user.keyboard already and don't really
-        // add much value if we provide that to them
-        this.toggleSelectAll = async (opts = {})=>{
-            let { interactionType: interactionType = this._interactionType } = opts;
-            let checkbox = (0, $2auAU$testinglibraryreact.within)(this.table).getByLabelText('Select All');
-            if (interactionType === 'keyboard') // TODO: using the .focus -> trigger keyboard Enter approach doesn't work for some reason, for now just trigger select all with click.
-            await this.user.click(checkbox);
-            else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, checkbox, interactionType);
-        };
-        this.findRow = (opts = {})=>{
-            let { index: index, text: text } = opts;
-            let row;
-            let rows = this.rows;
-            let bodyRowGroup = this.rowGroups[1];
-            if (index != null) row = rows[index];
-            else if (text != null) {
-                row = (0, $2auAU$testinglibraryreact.within)(bodyRowGroup).getByText(text);
-                while(row && row.getAttribute('role') !== 'row')row = row.parentElement;
-            }
-            return row;
-        };
-        this.findCell = (opts)=>{
-            let { text: text } = opts;
-            let cell = (0, $2auAU$testinglibraryreact.within)(this.table).getByText(text);
-            if (cell) while(cell && !/gridcell|rowheader|columnheader/.test(cell.getAttribute('role') || '')){
-                if (cell.parentElement) cell = cell.parentElement;
-                else break;
-            }
-            return cell;
-        };
         let { root: root, user: user, interactionType: interactionType, advanceTimer: advanceTimer } = opts;
         this.user = user;
         this._interactionType = interactionType || 'mouse';