@react-aria/test-utils 1.0.0-nightly.5041 → 1.0.0-rc.0

package/dist/private/combobox.cjs

@@ -0,0 +1,199 @@
+var $a84d573878cc1e5e$exports = require("./act.cjs");
+var $022fcf8e360befed$exports = require("./utils.cjs");
+var $btaxF$testinglibrarydom = require("@testing-library/dom");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "ComboBoxTester", function () { return $2cdddd94ee78eafe$export$f97e14e96d71ab3b; });
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+class $2cdddd94ee78eafe$export$f97e14e96d71ab3b {
+    constructor(opts){
+        let { root: root, trigger: trigger, user: user, interactionType: interactionType } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to
+        // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis
+        this._combobox = root;
+        let combobox = (0, $btaxF$testinglibrarydom.within)(root).queryByRole('combobox');
+        if (combobox) this._combobox = combobox;
+        // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)
+        if (trigger) this._trigger = trigger;
+        else {
+            let buttons = (0, $btaxF$testinglibrarydom.within)(root).queryAllByRole('button', {
+                hidden: true
+            });
+            if (buttons.length === 1) trigger = buttons[0];
+            else if (buttons.length > 1) trigger = buttons.find((button)=>button.hasAttribute('aria-haspopup'));
+            // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox
+            // is also the trigger button
+            this._trigger = trigger || this._combobox;
+        }
+    }
+    /**
+   * Set the interaction type used by the combobox tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Opens the combobox dropdown. Defaults to using the interaction type set on the combobox tester.
+   */ async open(opts = {}) {
+        let { triggerBehavior: triggerBehavior = 'manual', interactionType: interactionType = this._interactionType } = opts;
+        let trigger = this.getTrigger();
+        let combobox = this.getCombobox();
+        let isDisabled = trigger.hasAttribute('disabled');
+        if (interactionType === 'mouse') {
+            if (triggerBehavior === 'focus') await this.user.click(combobox);
+            else await this.user.click(trigger);
+        } else if (interactionType === 'keyboard') {
+            (0, $a84d573878cc1e5e$exports.act)(()=>combobox.focus());
+            if (triggerBehavior !== 'focus') await this.user.keyboard('{ArrowDown}');
+        } else if (interactionType === 'touch') {
+            if (triggerBehavior === 'focus') await this.user.pointer({
+                target: combobox,
+                keys: '[TouchA]'
+            });
+            else await this.user.pointer({
+                target: trigger,
+                keys: '[TouchA]'
+            });
+        }
+        await (0, $btaxF$testinglibrarydom.waitFor)(()=>{
+            if (!isDisabled && combobox.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on combobox trigger element.');
+            else return true;
+        });
+        let listBoxId = combobox.getAttribute('aria-controls');
+        await (0, $btaxF$testinglibrarydom.waitFor)(()=>{
+            if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) throw new Error(`Listbox with id of ${listBoxId} not found in document.`);
+            else return true;
+        });
+    }
+    /**
+   * Returns an option matching the specified index or text content.
+   */ findOption(opts) {
+        let { indexOrText: indexOrText } = opts;
+        let option;
+        let options = this.getOptions();
+        let listbox = this.getListbox();
+        if (typeof indexOrText === 'number') option = options[indexOrText];
+        else if (typeof indexOrText === 'string' && listbox != null) option = (0, $btaxF$testinglibrarydom.within)(listbox).getByText(indexOrText).closest('[role=option]');
+        return option;
+    }
+    async keyboardNavigateToOption(opts) {
+        let { option: option } = opts;
+        let combobox = this.getCombobox();
+        let options = this.getOptions();
+        let targetIndex = options.findIndex((opt)=>opt === option || opt.contains(option));
+        if (targetIndex === -1) throw new Error('Option provided is not in the combobox listbox.');
+        let getCurrentIndex = ()=>{
+            let id = combobox.getAttribute('aria-activedescendant');
+            if (!id) return -1;
+            return options.findIndex((opt)=>opt.id === id);
+        };
+        if (getCurrentIndex() === -1) await this.user.keyboard('[ArrowDown]');
+        let currIndex = getCurrentIndex();
+        if (currIndex === -1) throw new Error('Could not determine the current option in the combobox 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'}]`);
+    }
+    /**
+   * Toggles the selection of the desired combobox option if possible. Defaults to using the
+   * interaction type set on the combobox tester. If necessary, will open the combobox dropdown
+   * beforehand. The desired option can be targeted via the option's node, the option's text, or the
+   * option's index.
+   */ async toggleOptionSelection(opts) {
+        let { option: option, triggerBehavior: triggerBehavior, interactionType: interactionType = this._interactionType, closesOnSelect: closesOnSelect } = opts;
+        if (!this.getCombobox().getAttribute('aria-controls')) await this.open({
+            triggerBehavior: triggerBehavior
+        });
+        let listbox = this.getListbox();
+        if (!listbox) throw new Error("Combobox's listbox not found.");
+        if (typeof option === 'string' || typeof option === 'number') option = this.findOption({
+            indexOrText: option
+        });
+        if (!option) throw new Error(`Target option "${(0, $022fcf8e360befed$exports.formatTargetNode)(opts.option)}" not found in the listbox.`);
+        let isMultiSelect = listbox.getAttribute('aria-multiselectable') === 'true';
+        closesOnSelect = closesOnSelect ?? !isMultiSelect;
+        if (interactionType === 'keyboard') {
+            await this.keyboardNavigateToOption({
+                option: option
+            });
+            await this.user.keyboard('[Enter]');
+        } else if (interactionType === 'mouse') await this.user.click(option);
+        else await this.user.pointer({
+            target: option,
+            keys: '[TouchA]'
+        });
+        if (closesOnSelect && option.getAttribute('href') == null) await (0, $btaxF$testinglibrarydom.waitFor)(()=>{
+            if (document.contains(listbox)) throw new Error('Expected listbox element to not be in the document after selecting an option');
+            else return true;
+        });
+    }
+    /**
+   * Closes the combobox dropdown.
+   */ async close() {
+        let listbox = this.getListbox();
+        if (listbox) {
+            (0, $a84d573878cc1e5e$exports.act)(()=>this.getCombobox().focus());
+            await this.user.keyboard('[Escape]');
+            await (0, $btaxF$testinglibrarydom.waitFor)(()=>{
+                if (document.contains(listbox)) throw new Error('Expected listbox element to not be in the document after selecting an option');
+                else return true;
+            });
+        }
+    }
+    /**
+   * Returns the combobox.
+   */ getCombobox() {
+        return this._combobox;
+    }
+    /**
+   * Returns the combobox trigger button.
+   */ getTrigger() {
+        return this._trigger;
+    }
+    /**
+   * Returns the combobox's listbox if present.
+   */ getListbox() {
+        let listBoxId = this.getCombobox().getAttribute('aria-controls');
+        return listBoxId ? document.getElementById(listBoxId) || null : null;
+    }
+    /**
+   * Returns the combobox's sections if present.
+   */ getSections() {
+        let listbox = this.getListbox();
+        return listbox ? (0, $btaxF$testinglibrarydom.within)(listbox).queryAllByRole('group') : [];
+    }
+    /**
+   * Returns the combobox's options if present. Can be filtered to a subsection of the listbox if
+   * provided via `element`.
+   */ getOptions(opts = {}) {
+        let { element: element = this.getListbox() } = opts;
+        let options = [];
+        if (element) options = (0, $btaxF$testinglibrarydom.within)(element).queryAllByRole('option');
+        return options;
+    }
+    /**
+   * Returns the currently focused option in the combobox's dropdown if any.
+   */ getFocusedOption() {
+        let focusedOptionId = this.getCombobox().getAttribute('aria-activedescendant');
+        return focusedOptionId ? document.getElementById(focusedOptionId) : null;
+    }
+}
+
+
+//# sourceMappingURL=combobox.cjs.map

package/dist/private/combobox.cjs.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/@react-aria/test-utils/src/combobox.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} from './act';\nimport {ComboBoxTesterOpts, UserOpts} from './types';\nimport {formatTargetNode} from './utils';\nimport {waitFor, within} from '@testing-library/dom';\n\ninterface ComboBoxOpenOpts {\n  /**\n   * Whether the combobox opens on focus or needs to be manually opened via user action.\n   *\n   * @default 'manual'\n   */\n  triggerBehavior?: 'focus' | 'manual';\n  /**\n   * What interaction type to use when opening the combobox. Defaults to the interaction type set on\n   * the tester.\n   */\n  interactionType?: UserOpts['interactionType'];\n}\n\ninterface ComboBoxSelectOpts extends ComboBoxOpenOpts {\n  /**\n   * The index, text, or node of the option to select. Option nodes can be sourced via\n   * `getOptions()`.\n   */\n  option: number | string | HTMLElement;\n  /**\n   * Whether or not the combobox closes on selection. Defaults to `true` for single select\n   * comboboxes and `false` for multi-select comboboxes.\n   */\n  closesOnSelect?: boolean;\n}\n\nexport class ComboBoxTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _combobox: HTMLElement;\n  private _trigger: HTMLElement;\n\n  constructor(opts: ComboBoxTesterOpts) {\n    let {root, trigger, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n\n    // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to\n    // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis\n    this._combobox = root;\n    let combobox = within(root).queryByRole('combobox');\n    if (combobox) {\n      this._combobox = combobox;\n    }\n\n    // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)\n    if (trigger) {\n      this._trigger = trigger;\n    } else {\n      let buttons = within(root).queryAllByRole('button', {hidden: true});\n\n      if (buttons.length === 1) {\n        trigger = buttons[0];\n      } else if (buttons.length > 1) {\n        trigger = buttons.find(button => button.hasAttribute('aria-haspopup'));\n      }\n\n      // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox\n      // is also the trigger button\n      this._trigger = trigger || this._combobox;\n    }\n  }\n\n  /**\n   * Set the interaction type used by the combobox tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Opens the combobox dropdown. Defaults to using the interaction type set on the combobox tester.\n   */\n  async open(opts: ComboBoxOpenOpts = {}): Promise<void> {\n    let {triggerBehavior = 'manual', interactionType = this._interactionType} = opts;\n    let trigger = this.getTrigger();\n    let combobox = this.getCombobox();\n    let isDisabled = trigger!.hasAttribute('disabled');\n\n    if (interactionType === 'mouse') {\n      if (triggerBehavior === 'focus') {\n        await this.user.click(combobox);\n      } else {\n        await this.user.click(trigger);\n      }\n    } else if (interactionType === 'keyboard') {\n      act(() => combobox.focus());\n      if (triggerBehavior !== 'focus') {\n        await this.user.keyboard('{ArrowDown}');\n      }\n    } else if (interactionType === 'touch') {\n      if (triggerBehavior === 'focus') {\n        await this.user.pointer({target: combobox, keys: '[TouchA]'});\n      } else {\n        await this.user.pointer({target: trigger, keys: '[TouchA]'});\n      }\n    }\n\n    await waitFor(() => {\n      if (!isDisabled && combobox.getAttribute('aria-controls') == null) {\n        throw new Error('No aria-controls found on combobox trigger element.');\n      } else {\n        return true;\n      }\n    });\n    let listBoxId = combobox.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   * Returns an option matching the specified index or text content.\n   */\n  findOption(opts: {indexOrText: number | string}): HTMLElement {\n    let {indexOrText} = opts;\n\n    let option;\n    let options = this.getOptions();\n    let listbox = this.getListbox();\n\n    if (typeof indexOrText === 'number') {\n      option = options[indexOrText];\n    } else if (typeof indexOrText === 'string' && listbox != null) {\n      option = within(listbox!).getByText(indexOrText).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 combobox = this.getCombobox();\n    let options = this.getOptions();\n    let targetIndex = options.findIndex(opt => opt === option || opt.contains(option));\n    if (targetIndex === -1) {\n      throw new Error('Option provided is not in the combobox listbox.');\n    }\n\n    let getCurrentIndex = () => {\n      let id = combobox.getAttribute('aria-activedescendant');\n      if (!id) {\n        return -1;\n      }\n      return options.findIndex(opt => opt.id === id);\n    };\n\n    if (getCurrentIndex() === -1) {\n      await this.user.keyboard('[ArrowDown]');\n    }\n\n    let currIndex = getCurrentIndex();\n    if (currIndex === -1) {\n      throw new Error('Could not determine the current option in the combobox listbox.');\n    }\n\n    let direction = targetIndex > currIndex ? 'down' : 'up';\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   * Toggles the selection of the desired combobox option if possible. Defaults to using the\n   * interaction type set on the combobox tester. If necessary, will open the combobox dropdown\n   * beforehand. The desired option can be targeted via the option's node, the option's text, or the\n   * option's index.\n   */\n  async toggleOptionSelection(opts: ComboBoxSelectOpts): Promise<void> {\n    let {option, triggerBehavior, interactionType = this._interactionType, closesOnSelect} = opts;\n    if (!this.getCombobox().getAttribute('aria-controls')) {\n      await this.open({triggerBehavior});\n    }\n\n    let listbox = this.getListbox();\n    if (!listbox) {\n      throw new Error(\"Combobox's listbox not found.\");\n    }\n\n    if (typeof option === 'string' || typeof option === 'number') {\n      option = this.findOption({indexOrText: option});\n    }\n\n    if (!option) {\n      throw new Error(`Target option \"${formatTargetNode(opts.option)}\" not found in the listbox.`);\n    }\n\n    let isMultiSelect = listbox.getAttribute('aria-multiselectable') === 'true';\n    closesOnSelect = closesOnSelect ?? !isMultiSelect;\n\n    if (interactionType === 'keyboard') {\n      await this.keyboardNavigateToOption({option});\n      await this.user.keyboard('[Enter]');\n    } else if (interactionType === 'mouse') {\n      await this.user.click(option);\n    } else {\n      await this.user.pointer({target: option, keys: '[TouchA]'});\n    }\n\n    if (closesOnSelect && option.getAttribute('href') == null) {\n      await waitFor(() => {\n        if (document.contains(listbox)) {\n          throw new Error(\n            'Expected listbox element to not be in the document after selecting an option'\n          );\n        } else {\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Closes the combobox dropdown.\n   */\n  async close(): Promise<void> {\n    let listbox = this.getListbox();\n    if (listbox) {\n      act(() => this.getCombobox().focus());\n      await this.user.keyboard('[Escape]');\n\n      await waitFor(() => {\n        if (document.contains(listbox)) {\n          throw new Error(\n            'Expected listbox element to not be in the document after selecting an option'\n          );\n        } else {\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Returns the combobox.\n   */\n  getCombobox(): HTMLElement {\n    return this._combobox;\n  }\n\n  /**\n   * Returns the combobox trigger button.\n   */\n  getTrigger(): HTMLElement {\n    return this._trigger;\n  }\n\n  /**\n   * Returns the combobox's listbox if present.\n   */\n  getListbox(): HTMLElement | null {\n    let listBoxId = this.getCombobox().getAttribute('aria-controls');\n    return listBoxId ? document.getElementById(listBoxId) || null : null;\n  }\n\n  /**\n   * Returns the combobox's sections if present.\n   */\n  getSections(): HTMLElement[] {\n    let listbox = this.getListbox();\n    return listbox ? within(listbox).queryAllByRole('group') : [];\n  }\n\n  /**\n   * Returns the combobox's options if present. Can be filtered to a subsection of the listbox if\n   * provided via `element`.\n   */\n  getOptions(opts: {element?: HTMLElement} = {}): HTMLElement[] {\n    let {element = this.getListbox()} = opts;\n    let options = [];\n    if (element) {\n      options = within(element).queryAllByRole('option');\n    }\n\n    return options;\n  }\n\n  /**\n   * Returns the currently focused option in the combobox's dropdown if any.\n   */\n  getFocusedOption(): HTMLElement | null {\n    let focusedOptionId = this.getCombobox().getAttribute('aria-activedescendant');\n    return focusedOptionId ? document.getElementById(focusedOptionId) : null;\n  }\n}\n"],"names":[],"version":3,"file":"combobox.cjs.map"}

package/dist/private/combobox.js

@@ -0,0 +1,194 @@
+import {act as $1350703ef3ac1acc$export$3ba232387fd5d6dd} from "./act.js";
+import {formatTargetNode as $b4e037a2907521c6$export$bc3bc4a9206bf789} from "./utils.js";
+import {within as $d5vWN$within, waitFor as $d5vWN$waitFor} from "@testing-library/dom";
+
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+class $a2202d8b369e6a8a$export$f97e14e96d71ab3b {
+    constructor(opts){
+        let { root: root, trigger: trigger, user: user, interactionType: interactionType } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to
+        // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis
+        this._combobox = root;
+        let combobox = (0, $d5vWN$within)(root).queryByRole('combobox');
+        if (combobox) this._combobox = combobox;
+        // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)
+        if (trigger) this._trigger = trigger;
+        else {
+            let buttons = (0, $d5vWN$within)(root).queryAllByRole('button', {
+                hidden: true
+            });
+            if (buttons.length === 1) trigger = buttons[0];
+            else if (buttons.length > 1) trigger = buttons.find((button)=>button.hasAttribute('aria-haspopup'));
+            // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox
+            // is also the trigger button
+            this._trigger = trigger || this._combobox;
+        }
+    }
+    /**
+   * Set the interaction type used by the combobox tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Opens the combobox dropdown. Defaults to using the interaction type set on the combobox tester.
+   */ async open(opts = {}) {
+        let { triggerBehavior: triggerBehavior = 'manual', interactionType: interactionType = this._interactionType } = opts;
+        let trigger = this.getTrigger();
+        let combobox = this.getCombobox();
+        let isDisabled = trigger.hasAttribute('disabled');
+        if (interactionType === 'mouse') {
+            if (triggerBehavior === 'focus') await this.user.click(combobox);
+            else await this.user.click(trigger);
+        } else if (interactionType === 'keyboard') {
+            (0, $1350703ef3ac1acc$export$3ba232387fd5d6dd)(()=>combobox.focus());
+            if (triggerBehavior !== 'focus') await this.user.keyboard('{ArrowDown}');
+        } else if (interactionType === 'touch') {
+            if (triggerBehavior === 'focus') await this.user.pointer({
+                target: combobox,
+                keys: '[TouchA]'
+            });
+            else await this.user.pointer({
+                target: trigger,
+                keys: '[TouchA]'
+            });
+        }
+        await (0, $d5vWN$waitFor)(()=>{
+            if (!isDisabled && combobox.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on combobox trigger element.');
+            else return true;
+        });
+        let listBoxId = combobox.getAttribute('aria-controls');
+        await (0, $d5vWN$waitFor)(()=>{
+            if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) throw new Error(`Listbox with id of ${listBoxId} not found in document.`);
+            else return true;
+        });
+    }
+    /**
+   * Returns an option matching the specified index or text content.
+   */ findOption(opts) {
+        let { indexOrText: indexOrText } = opts;
+        let option;
+        let options = this.getOptions();
+        let listbox = this.getListbox();
+        if (typeof indexOrText === 'number') option = options[indexOrText];
+        else if (typeof indexOrText === 'string' && listbox != null) option = (0, $d5vWN$within)(listbox).getByText(indexOrText).closest('[role=option]');
+        return option;
+    }
+    async keyboardNavigateToOption(opts) {
+        let { option: option } = opts;
+        let combobox = this.getCombobox();
+        let options = this.getOptions();
+        let targetIndex = options.findIndex((opt)=>opt === option || opt.contains(option));
+        if (targetIndex === -1) throw new Error('Option provided is not in the combobox listbox.');
+        let getCurrentIndex = ()=>{
+            let id = combobox.getAttribute('aria-activedescendant');
+            if (!id) return -1;
+            return options.findIndex((opt)=>opt.id === id);
+        };
+        if (getCurrentIndex() === -1) await this.user.keyboard('[ArrowDown]');
+        let currIndex = getCurrentIndex();
+        if (currIndex === -1) throw new Error('Could not determine the current option in the combobox 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'}]`);
+    }
+    /**
+   * Toggles the selection of the desired combobox option if possible. Defaults to using the
+   * interaction type set on the combobox tester. If necessary, will open the combobox dropdown
+   * beforehand. The desired option can be targeted via the option's node, the option's text, or the
+   * option's index.
+   */ async toggleOptionSelection(opts) {
+        let { option: option, triggerBehavior: triggerBehavior, interactionType: interactionType = this._interactionType, closesOnSelect: closesOnSelect } = opts;
+        if (!this.getCombobox().getAttribute('aria-controls')) await this.open({
+            triggerBehavior: triggerBehavior
+        });
+        let listbox = this.getListbox();
+        if (!listbox) throw new Error("Combobox's listbox not found.");
+        if (typeof option === 'string' || typeof option === 'number') option = this.findOption({
+            indexOrText: option
+        });
+        if (!option) throw new Error(`Target option "${(0, $b4e037a2907521c6$export$bc3bc4a9206bf789)(opts.option)}" not found in the listbox.`);
+        let isMultiSelect = listbox.getAttribute('aria-multiselectable') === 'true';
+        closesOnSelect = closesOnSelect ?? !isMultiSelect;
+        if (interactionType === 'keyboard') {
+            await this.keyboardNavigateToOption({
+                option: option
+            });
+            await this.user.keyboard('[Enter]');
+        } else if (interactionType === 'mouse') await this.user.click(option);
+        else await this.user.pointer({
+            target: option,
+            keys: '[TouchA]'
+        });
+        if (closesOnSelect && option.getAttribute('href') == null) await (0, $d5vWN$waitFor)(()=>{
+            if (document.contains(listbox)) throw new Error('Expected listbox element to not be in the document after selecting an option');
+            else return true;
+        });
+    }
+    /**
+   * Closes the combobox dropdown.
+   */ async close() {
+        let listbox = this.getListbox();
+        if (listbox) {
+            (0, $1350703ef3ac1acc$export$3ba232387fd5d6dd)(()=>this.getCombobox().focus());
+            await this.user.keyboard('[Escape]');
+            await (0, $d5vWN$waitFor)(()=>{
+                if (document.contains(listbox)) throw new Error('Expected listbox element to not be in the document after selecting an option');
+                else return true;
+            });
+        }
+    }
+    /**
+   * Returns the combobox.
+   */ getCombobox() {
+        return this._combobox;
+    }
+    /**
+   * Returns the combobox trigger button.
+   */ getTrigger() {
+        return this._trigger;
+    }
+    /**
+   * Returns the combobox's listbox if present.
+   */ getListbox() {
+        let listBoxId = this.getCombobox().getAttribute('aria-controls');
+        return listBoxId ? document.getElementById(listBoxId) || null : null;
+    }
+    /**
+   * Returns the combobox's sections if present.
+   */ getSections() {
+        let listbox = this.getListbox();
+        return listbox ? (0, $d5vWN$within)(listbox).queryAllByRole('group') : [];
+    }
+    /**
+   * Returns the combobox's options if present. Can be filtered to a subsection of the listbox if
+   * provided via `element`.
+   */ getOptions(opts = {}) {
+        let { element: element = this.getListbox() } = opts;
+        let options = [];
+        if (element) options = (0, $d5vWN$within)(element).queryAllByRole('option');
+        return options;
+    }
+    /**
+   * Returns the currently focused option in the combobox's dropdown if any.
+   */ getFocusedOption() {
+        let focusedOptionId = this.getCombobox().getAttribute('aria-activedescendant');
+        return focusedOptionId ? document.getElementById(focusedOptionId) : null;
+    }
+}
+
+
+export {$a2202d8b369e6a8a$export$f97e14e96d71ab3b as ComboBoxTester};
+//# sourceMappingURL=combobox.js.map

package/dist/private/combobox.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;AAAA;;;;;;;;;;CAUC;;;AAkCM,MAAM;IAMX,YAAY,IAAwB,CAAE;QACpC,IAAI,QAAC,IAAI,WAAE,OAAO,QAAE,IAAI,mBAAE,eAAe,EAAC,GAAG;QAC7C,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,gBAAgB,GAAG,mBAAmB;QAE3C,8IAA8I;QAC9I,2FAA2F;QAC3F,IAAI,CAAC,SAAS,GAAG;QACjB,IAAI,WAAW,CAAA,GAAA,aAAK,EAAE,MAAM,WAAW,CAAC;QACxC,IAAI,UACF,IAAI,CAAC,SAAS,GAAG;QAGnB,6KAA6K;QAC7K,IAAI,SACF,IAAI,CAAC,QAAQ,GAAG;aACX;YACL,IAAI,UAAU,CAAA,GAAA,aAAK,EAAE,MAAM,cAAc,CAAC,UAAU;gBAAC,QAAQ;YAAI;YAEjE,IAAI,QAAQ,MAAM,KAAK,GACrB,UAAU,OAAO,CAAC,EAAE;iBACf,IAAI,QAAQ,MAAM,GAAG,GAC1B,UAAU,QAAQ,IAAI,CAAC,CAAA,SAAU,OAAO,YAAY,CAAC;YAGvD,qHAAqH;YACrH,6BAA6B;YAC7B,IAAI,CAAC,QAAQ,GAAG,WAAW,IAAI,CAAC,SAAS;QAC3C;IACF;IAEA;;GAEC,GACD,mBAAmB,IAAiC,EAAQ;QAC1D,IAAI,CAAC,gBAAgB,GAAG;IAC1B;IAEA;;GAEC,GACD,MAAM,KAAK,OAAyB,CAAC,CAAC,EAAiB;QACrD,IAAI,mBAAC,kBAAkB,2BAAU,kBAAkB,IAAI,CAAC,gBAAgB,EAAC,GAAG;QAC5E,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,WAAW,IAAI,CAAC,WAAW;QAC/B,IAAI,aAAa,QAAS,YAAY,CAAC;QAEvC,IAAI,oBAAoB;YACtB,IAAI,oBAAoB,SACtB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;iBAEtB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;eAEnB,IAAI,oBAAoB,YAAY;YACzC,CAAA,GAAA,yCAAE,EAAE,IAAM,SAAS,KAAK;YACxB,IAAI,oBAAoB,SACtB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAE7B,OAAO,IAAI,oBAAoB;YAC7B,IAAI,oBAAoB,SACtB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAC,QAAQ;gBAAU,MAAM;YAAU;iBAE3D,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAC,QAAQ;gBAAS,MAAM;YAAU;;QAI9D,MAAM,CAAA,GAAA,cAAM,EAAE;YACZ,IAAI,CAAC,cAAc,SAAS,YAAY,CAAC,oBAAoB,MAC3D,MAAM,IAAI,MAAM;iBAEhB,OAAO;QAEX;QACA,IAAI,YAAY,SAAS,YAAY,CAAC;QACtC,MAAM,CAAA,GAAA,cAAM,EAAE;YACZ,IAAI,CAAC,cAAe,CAAA,CAAC,aAAa,SAAS,cAAc,CAAC,cAAc,IAAG,GACzE,MAAM,IAAI,MAAM,CAAC,mBAAmB,EAAE,UAAU,uBAAuB,CAAC;iBAExE,OAAO;QAEX;IACF;IAEA;;GAEC,GACD,WAAW,IAAoC,EAAe;QAC5D,IAAI,eAAC,WAAW,EAAC,GAAG;QAEpB,IAAI;QACJ,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,UAAU,IAAI,CAAC,UAAU;QAE7B,IAAI,OAAO,gBAAgB,UACzB,SAAS,OAAO,CAAC,YAAY;aACxB,IAAI,OAAO,gBAAgB,YAAY,WAAW,MACvD,SAAS,CAAA,GAAA,aAAK,EAAE,SAAU,SAAS,CAAC,aAAa,OAAO,CAAC;QAG3D,OAAO;IACT;IAEA,MAAc,yBAAyB,IAA2B,EAAE;QAClE,IAAI,UAAC,MAAM,EAAC,GAAG;QACf,IAAI,WAAW,IAAI,CAAC,WAAW;QAC/B,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,cAAc,QAAQ,SAAS,CAAC,CAAA,MAAO,QAAQ,UAAU,IAAI,QAAQ,CAAC;QAC1E,IAAI,gBAAgB,IAClB,MAAM,IAAI,MAAM;QAGlB,IAAI,kBAAkB;YACpB,IAAI,KAAK,SAAS,YAAY,CAAC;YAC/B,IAAI,CAAC,IACH,OAAO;YAET,OAAO,QAAQ,SAAS,CAAC,CAAA,MAAO,IAAI,EAAE,KAAK;QAC7C;QAEA,IAAI,sBAAsB,IACxB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAG3B,IAAI,YAAY;QAChB,IAAI,cAAc,IAChB,MAAM,IAAI,MAAM;QAGlB,IAAI,YAAY,cAAc,YAAY,SAAS;QACnD,IAAK,IAAI,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,cAAc,YAAY,IACrD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,SAAS,cAAc,UAAU,CAAC,CAAC;IAElF;IAEA;;;;;GAKC,GACD,MAAM,sBAAsB,IAAwB,EAAiB;QACnE,IAAI,UAAC,MAAM,mBAAE,eAAe,mBAAE,kBAAkB,IAAI,CAAC,gBAAgB,kBAAE,cAAc,EAAC,GAAG;QACzF,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC,kBACnC,MAAM,IAAI,CAAC,IAAI,CAAC;6BAAC;QAAe;QAGlC,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,CAAC,SACH,MAAM,IAAI,MAAM;QAGlB,IAAI,OAAO,WAAW,YAAY,OAAO,WAAW,UAClD,SAAS,IAAI,CAAC,UAAU,CAAC;YAAC,aAAa;QAAM;QAG/C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAA,GAAA,yCAAe,EAAE,KAAK,MAAM,EAAE,2BAA2B,CAAC;QAG9F,IAAI,gBAAgB,QAAQ,YAAY,CAAC,4BAA4B;QACrE,iBAAiB,kBAAkB,CAAC;QAEpC,IAAI,oBAAoB,YAAY;YAClC,MAAM,IAAI,CAAC,wBAAwB,CAAC;wBAAC;YAAM;YAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC3B,OAAO,IAAI,oBAAoB,SAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;aAEtB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YAAC,QAAQ;YAAQ,MAAM;QAAU;QAG3D,IAAI,kBAAkB,OAAO,YAAY,CAAC,WAAW,MACnD,MAAM,CAAA,GAAA,cAAM,EAAE;YACZ,IAAI,SAAS,QAAQ,CAAC,UACpB,MAAM,IAAI,MACR;iBAGF,OAAO;QAEX;IAEJ;IAEA;;GAEC,GACD,MAAM,QAAuB;QAC3B,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,SAAS;YACX,CAAA,GAAA,yCAAE,EAAE,IAAM,IAAI,CAAC,WAAW,GAAG,KAAK;YAClC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAEzB,MAAM,CAAA,GAAA,cAAM,EAAE;gBACZ,IAAI,SAAS,QAAQ,CAAC,UACpB,MAAM,IAAI,MACR;qBAGF,OAAO;YAEX;QACF;IACF;IAEA;;GAEC,GACD,cAA2B;QACzB,OAAO,IAAI,CAAC,SAAS;IACvB;IAEA;;GAEC,GACD,aAA0B;QACxB,OAAO,IAAI,CAAC,QAAQ;IACtB;IAEA;;GAEC,GACD,aAAiC;QAC/B,IAAI,YAAY,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC;QAChD,OAAO,YAAY,SAAS,cAAc,CAAC,cAAc,OAAO;IAClE;IAEA;;GAEC,GACD,cAA6B;QAC3B,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,OAAO,UAAU,CAAA,GAAA,aAAK,EAAE,SAAS,cAAc,CAAC,WAAW,EAAE;IAC/D;IAEA;;;GAGC,GACD,WAAW,OAAgC,CAAC,CAAC,EAAiB;QAC5D,IAAI,WAAC,UAAU,IAAI,CAAC,UAAU,IAAG,GAAG;QACpC,IAAI,UAAU,EAAE;QAChB,IAAI,SACF,UAAU,CAAA,GAAA,aAAK,EAAE,SAAS,cAAc,CAAC;QAG3C,OAAO;IACT;IAEA;;GAEC,GACD,mBAAuC;QACrC,IAAI,kBAAkB,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC;QACtD,OAAO,kBAAkB,SAAS,cAAc,CAAC,mBAAmB;IACtE;AACF","sources":["packages/@react-aria/test-utils/src/combobox.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} from './act';\nimport {ComboBoxTesterOpts, UserOpts} from './types';\nimport {formatTargetNode} from './utils';\nimport {waitFor, within} from '@testing-library/dom';\n\ninterface ComboBoxOpenOpts {\n  /**\n   * Whether the combobox opens on focus or needs to be manually opened via user action.\n   *\n   * @default 'manual'\n   */\n  triggerBehavior?: 'focus' | 'manual';\n  /**\n   * What interaction type to use when opening the combobox. Defaults to the interaction type set on\n   * the tester.\n   */\n  interactionType?: UserOpts['interactionType'];\n}\n\ninterface ComboBoxSelectOpts extends ComboBoxOpenOpts {\n  /**\n   * The index, text, or node of the option to select. Option nodes can be sourced via\n   * `getOptions()`.\n   */\n  option: number | string | HTMLElement;\n  /**\n   * Whether or not the combobox closes on selection. Defaults to `true` for single select\n   * comboboxes and `false` for multi-select comboboxes.\n   */\n  closesOnSelect?: boolean;\n}\n\nexport class ComboBoxTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _combobox: HTMLElement;\n  private _trigger: HTMLElement;\n\n  constructor(opts: ComboBoxTesterOpts) {\n    let {root, trigger, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n\n    // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to\n    // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis\n    this._combobox = root;\n    let combobox = within(root).queryByRole('combobox');\n    if (combobox) {\n      this._combobox = combobox;\n    }\n\n    // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)\n    if (trigger) {\n      this._trigger = trigger;\n    } else {\n      let buttons = within(root).queryAllByRole('button', {hidden: true});\n\n      if (buttons.length === 1) {\n        trigger = buttons[0];\n      } else if (buttons.length > 1) {\n        trigger = buttons.find(button => button.hasAttribute('aria-haspopup'));\n      }\n\n      // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox\n      // is also the trigger button\n      this._trigger = trigger || this._combobox;\n    }\n  }\n\n  /**\n   * Set the interaction type used by the combobox tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Opens the combobox dropdown. Defaults to using the interaction type set on the combobox tester.\n   */\n  async open(opts: ComboBoxOpenOpts = {}): Promise<void> {\n    let {triggerBehavior = 'manual', interactionType = this._interactionType} = opts;\n    let trigger = this.getTrigger();\n    let combobox = this.getCombobox();\n    let isDisabled = trigger!.hasAttribute('disabled');\n\n    if (interactionType === 'mouse') {\n      if (triggerBehavior === 'focus') {\n        await this.user.click(combobox);\n      } else {\n        await this.user.click(trigger);\n      }\n    } else if (interactionType === 'keyboard') {\n      act(() => combobox.focus());\n      if (triggerBehavior !== 'focus') {\n        await this.user.keyboard('{ArrowDown}');\n      }\n    } else if (interactionType === 'touch') {\n      if (triggerBehavior === 'focus') {\n        await this.user.pointer({target: combobox, keys: '[TouchA]'});\n      } else {\n        await this.user.pointer({target: trigger, keys: '[TouchA]'});\n      }\n    }\n\n    await waitFor(() => {\n      if (!isDisabled && combobox.getAttribute('aria-controls') == null) {\n        throw new Error('No aria-controls found on combobox trigger element.');\n      } else {\n        return true;\n      }\n    });\n    let listBoxId = combobox.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   * Returns an option matching the specified index or text content.\n   */\n  findOption(opts: {indexOrText: number | string}): HTMLElement {\n    let {indexOrText} = opts;\n\n    let option;\n    let options = this.getOptions();\n    let listbox = this.getListbox();\n\n    if (typeof indexOrText === 'number') {\n      option = options[indexOrText];\n    } else if (typeof indexOrText === 'string' && listbox != null) {\n      option = within(listbox!).getByText(indexOrText).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 combobox = this.getCombobox();\n    let options = this.getOptions();\n    let targetIndex = options.findIndex(opt => opt === option || opt.contains(option));\n    if (targetIndex === -1) {\n      throw new Error('Option provided is not in the combobox listbox.');\n    }\n\n    let getCurrentIndex = () => {\n      let id = combobox.getAttribute('aria-activedescendant');\n      if (!id) {\n        return -1;\n      }\n      return options.findIndex(opt => opt.id === id);\n    };\n\n    if (getCurrentIndex() === -1) {\n      await this.user.keyboard('[ArrowDown]');\n    }\n\n    let currIndex = getCurrentIndex();\n    if (currIndex === -1) {\n      throw new Error('Could not determine the current option in the combobox listbox.');\n    }\n\n    let direction = targetIndex > currIndex ? 'down' : 'up';\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   * Toggles the selection of the desired combobox option if possible. Defaults to using the\n   * interaction type set on the combobox tester. If necessary, will open the combobox dropdown\n   * beforehand. The desired option can be targeted via the option's node, the option's text, or the\n   * option's index.\n   */\n  async toggleOptionSelection(opts: ComboBoxSelectOpts): Promise<void> {\n    let {option, triggerBehavior, interactionType = this._interactionType, closesOnSelect} = opts;\n    if (!this.getCombobox().getAttribute('aria-controls')) {\n      await this.open({triggerBehavior});\n    }\n\n    let listbox = this.getListbox();\n    if (!listbox) {\n      throw new Error(\"Combobox's listbox not found.\");\n    }\n\n    if (typeof option === 'string' || typeof option === 'number') {\n      option = this.findOption({indexOrText: option});\n    }\n\n    if (!option) {\n      throw new Error(`Target option \"${formatTargetNode(opts.option)}\" not found in the listbox.`);\n    }\n\n    let isMultiSelect = listbox.getAttribute('aria-multiselectable') === 'true';\n    closesOnSelect = closesOnSelect ?? !isMultiSelect;\n\n    if (interactionType === 'keyboard') {\n      await this.keyboardNavigateToOption({option});\n      await this.user.keyboard('[Enter]');\n    } else if (interactionType === 'mouse') {\n      await this.user.click(option);\n    } else {\n      await this.user.pointer({target: option, keys: '[TouchA]'});\n    }\n\n    if (closesOnSelect && option.getAttribute('href') == null) {\n      await waitFor(() => {\n        if (document.contains(listbox)) {\n          throw new Error(\n            'Expected listbox element to not be in the document after selecting an option'\n          );\n        } else {\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Closes the combobox dropdown.\n   */\n  async close(): Promise<void> {\n    let listbox = this.getListbox();\n    if (listbox) {\n      act(() => this.getCombobox().focus());\n      await this.user.keyboard('[Escape]');\n\n      await waitFor(() => {\n        if (document.contains(listbox)) {\n          throw new Error(\n            'Expected listbox element to not be in the document after selecting an option'\n          );\n        } else {\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Returns the combobox.\n   */\n  getCombobox(): HTMLElement {\n    return this._combobox;\n  }\n\n  /**\n   * Returns the combobox trigger button.\n   */\n  getTrigger(): HTMLElement {\n    return this._trigger;\n  }\n\n  /**\n   * Returns the combobox's listbox if present.\n   */\n  getListbox(): HTMLElement | null {\n    let listBoxId = this.getCombobox().getAttribute('aria-controls');\n    return listBoxId ? document.getElementById(listBoxId) || null : null;\n  }\n\n  /**\n   * Returns the combobox's sections if present.\n   */\n  getSections(): HTMLElement[] {\n    let listbox = this.getListbox();\n    return listbox ? within(listbox).queryAllByRole('group') : [];\n  }\n\n  /**\n   * Returns the combobox's options if present. Can be filtered to a subsection of the listbox if\n   * provided via `element`.\n   */\n  getOptions(opts: {element?: HTMLElement} = {}): HTMLElement[] {\n    let {element = this.getListbox()} = opts;\n    let options = [];\n    if (element) {\n      options = within(element).queryAllByRole('option');\n    }\n\n    return options;\n  }\n\n  /**\n   * Returns the currently focused option in the combobox's dropdown if any.\n   */\n  getFocusedOption(): HTMLElement | null {\n    let focusedOptionId = this.getCombobox().getAttribute('aria-activedescendant');\n    return focusedOptionId ? document.getElementById(focusedOptionId) : null;\n  }\n}\n"],"names":[],"version":3,"file":"combobox.js.map"}

package/dist/private/dialog.cjs

@@ -0,0 +1,110 @@
+var $a84d573878cc1e5e$exports = require("./act.cjs");
+var $4WTiJ$testinglibrarydom = require("@testing-library/dom");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "DialogTester", function () { return $cde1dbf8bdfa11d9$export$e79328f5295cc2a1; });
+/*
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+class $cde1dbf8bdfa11d9$export$e79328f5295cc2a1 {
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType, overlayType: overlayType } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._overlayType = overlayType || 'modal';
+        // Handle case where element provided is a wrapper of the trigger button.
+        let buttons = (0, $4WTiJ$testinglibrarydom.within)(root).queryAllByRole('button');
+        let triggerButton;
+        if (buttons.length === 0) triggerButton = root;
+        else if (buttons.length === 1) triggerButton = buttons[0];
+        else triggerButton = buttons.find((button)=>button.hasAttribute('aria-haspopup'));
+        this._trigger = triggerButton ?? root;
+    }
+    /**
+   * Set the interaction type used by the dialog tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Opens the dialog. Defaults to using the interaction type set on the dialog tester.
+   */ async open(opts = {}) {
+        let { interactionType: interactionType = this._interactionType } = opts;
+        let trigger = this.getTrigger();
+        if (!trigger.hasAttribute('disabled')) {
+            if (interactionType === 'mouse') await this.user.click(trigger);
+            else if (interactionType === 'touch') await this.user.pointer({
+                target: trigger,
+                keys: '[TouchA]'
+            });
+            else if (interactionType === 'keyboard') {
+                (0, $a84d573878cc1e5e$exports.act)(()=>trigger.focus());
+                await this.user.keyboard('[Enter]');
+            }
+            if (this._overlayType === 'popover') {
+                await (0, $4WTiJ$testinglibrarydom.waitFor)(()=>{
+                    if (trigger.getAttribute('aria-controls') == null) throw new Error('No aria-controls found on dialog trigger element.');
+                    else return true;
+                });
+                let dialogId = trigger.getAttribute('aria-controls');
+                await (0, $4WTiJ$testinglibrarydom.waitFor)(()=>{
+                    if (!dialogId || document.getElementById(dialogId) == null) throw new Error(`Dialog with id of ${dialogId} not found in document.`);
+                    else {
+                        this._dialog = document.getElementById(dialogId);
+                        return true;
+                    }
+                });
+            } else {
+                let dialog;
+                await (0, $4WTiJ$testinglibrarydom.waitFor)(()=>{
+                    dialog = document.querySelector('[role=dialog], [role=alertdialog]');
+                    if (dialog == null) throw new Error('No dialog of type role="dialog" or role="alertdialog" found after pressing the trigger.');
+                    else return true;
+                });
+                if (dialog && document.activeElement !== this._trigger && dialog.contains(document.activeElement)) this._dialog = dialog;
+                else throw new Error('New modal dialog doesnt contain the active element OR the active element is still the trigger. Uncertain if the proper modal dialog was found');
+            }
+        }
+    }
+    /**
+   * Closes the dialog via the Escape key.
+   */ async close() {
+        let dialog = this._dialog;
+        if (dialog) {
+            await this.user.keyboard('[Escape]');
+            await (0, $4WTiJ$testinglibrarydom.waitFor)(()=>{
+                if (document.contains(dialog)) throw new Error('Expected the dialog to not be in the document after closing it.');
+                else {
+                    this._dialog = undefined;
+                    return true;
+                }
+            });
+        }
+    }
+    /**
+   * Returns the dialog's trigger.
+   */ getTrigger() {
+        if (!this._trigger) throw new Error('No trigger element found for dialog.');
+        return this._trigger;
+    }
+    /**
+   * Returns the dialog if present.
+   */ getDialog() {
+        return this._dialog && document.contains(this._dialog) ? this._dialog : null;
+    }
+}
+
+
+//# sourceMappingURL=dialog.cjs.map

package/dist/private/dialog.cjs.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;AAAA;;;;;;;;;;CAUC;;AAcM,MAAM;IAOX,YAAY,IAAsB,CAAE;QAClC,IAAI,QAAC,IAAI,QAAE,IAAI,mBAAE,eAAe,eAAE,WAAW,EAAC,GAAG;QACjD,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,gBAAgB,GAAG,mBAAmB;QAC3C,IAAI,CAAC,YAAY,GAAG,eAAe;QAEnC,yEAAyE;QACzE,IAAI,UAAU,CAAA,GAAA,+BAAK,EAAE,MAAM,cAAc,CAAC;QAC1C,IAAI;QACJ,IAAI,QAAQ,MAAM,KAAK,GACrB,gBAAgB;aACX,IAAI,QAAQ,MAAM,KAAK,GAC5B,gBAAgB,OAAO,CAAC,EAAE;aAE1B,gBAAgB,QAAQ,IAAI,CAAC,CAAA,SAAU,OAAO,YAAY,CAAC;QAE7D,IAAI,CAAC,QAAQ,GAAG,iBAAiB;IACnC;IAEA;;GAEC,GACD,mBAAmB,IAAiC,EAAQ;QAC1D,IAAI,CAAC,gBAAgB,GAAG;IAC1B;IAEA;;GAEC,GACD,MAAM,KAAK,OAAuB,CAAC,CAAC,EAAiB;QACnD,IAAI,mBAAC,kBAAkB,IAAI,CAAC,gBAAgB,EAAC,GAAG;QAChD,IAAI,UAAU,IAAI,CAAC,UAAU;QAC7B,IAAI,CAAC,QAAQ,YAAY,CAAC,aAAa;YACrC,IAAI,oBAAoB,SACtB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;iBACjB,IAAI,oBAAoB,SAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAC,QAAQ;gBAAS,MAAM;YAAU;iBACrD,IAAI,oBAAoB,YAAY;gBACzC,CAAA,GAAA,6BAAE,EAAE,IAAM,QAAQ,KAAK;gBACvB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC3B;YAEA,IAAI,IAAI,CAAC,YAAY,KAAK,WAAW;gBACnC,MAAM,CAAA,GAAA,gCAAM,EAAE;oBACZ,IAAI,QAAQ,YAAY,CAAC,oBAAoB,MAC3C,MAAM,IAAI,MAAM;yBAEhB,OAAO;gBAEX;gBAEA,IAAI,WAAW,QAAQ,YAAY,CAAC;gBACpC,MAAM,CAAA,GAAA,gCAAM,EAAE;oBACZ,IAAI,CAAC,YAAY,SAAS,cAAc,CAAC,aAAa,MACpD,MAAM,IAAI,MAAM,CAAC,kBAAkB,EAAE,SAAS,uBAAuB,CAAC;yBACjE;wBACL,IAAI,CAAC,OAAO,GAAG,SAAS,cAAc,CAAC;wBACvC,OAAO;oBACT;gBACF;YACF,OAAO;gBACL,IAAI;gBACJ,MAAM,CAAA,GAAA,gCAAM,EAAE;oBACZ,SAAS,SAAS,aAAa,CAAC;oBAChC,IAAI,UAAU,MACZ,MAAM,IAAI,MACR;yBAGF,OAAO;gBAEX;gBAEA,IACE,UACA,SAAS,aAAa,KAAK,IAAI,CAAC,QAAQ,IACxC,OAAO,QAAQ,CAAC,SAAS,aAAa,GAEtC,IAAI,CAAC,OAAO,GAAG;qBAEf,MAAM,IAAI,MACR;YAGN;QACF;IACF;IAEA;;GAEC,GACD,MAAM,QAAuB;QAC3B,IAAI,SAAS,IAAI,CAAC,OAAO;QACzB,IAAI,QAAQ;YACV,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACzB,MAAM,CAAA,GAAA,gCAAM,EAAE;gBACZ,IAAI,SAAS,QAAQ,CAAC,SACpB,MAAM,IAAI,MAAM;qBACX;oBACL,IAAI,CAAC,OAAO,GAAG;oBACf,OAAO;gBACT;YACF;QACF;IACF;IAEA;;GAEC,GACD,aAA0B;QACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAChB,MAAM,IAAI,MAAM;QAGlB,OAAO,IAAI,CAAC,QAAQ;IACtB;IAEA;;GAEC,GACD,YAAgC;QAC9B,OAAO,IAAI,CAAC,OAAO,IAAI,SAAS,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG;IAC1E;AACF","sources":["packages/@react-aria/test-utils/src/dialog.ts"],"sourcesContent":["/*\n * Copyright 2025 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} from './act';\nimport {DialogTesterOpts, UserOpts} from './types';\nimport {waitFor, within} from '@testing-library/dom';\n\ninterface DialogOpenOpts {\n  /**\n   * What interaction type to use when opening the dialog. Defaults to the interaction type set on\n   * the tester.\n   */\n  interactionType?: UserOpts['interactionType'];\n}\n\nexport class DialogTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _trigger: HTMLElement | undefined;\n  private _dialog: HTMLElement | undefined;\n  private _overlayType: DialogTesterOpts['overlayType'];\n\n  constructor(opts: DialogTesterOpts) {\n    let {root, user, interactionType, overlayType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n    this._overlayType = overlayType || 'modal';\n\n    // Handle case where element provided is a wrapper of the trigger button.\n    let buttons = within(root).queryAllByRole('button');\n    let triggerButton: HTMLElement | undefined;\n    if (buttons.length === 0) {\n      triggerButton = root;\n    } else if (buttons.length === 1) {\n      triggerButton = buttons[0];\n    } else {\n      triggerButton = buttons.find(button => button.hasAttribute('aria-haspopup'));\n    }\n    this._trigger = triggerButton ?? root;\n  }\n\n  /**\n   * Set the interaction type used by the dialog tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Opens the dialog. Defaults to using the interaction type set on the dialog tester.\n   */\n  async open(opts: DialogOpenOpts = {}): Promise<void> {\n    let {interactionType = this._interactionType} = opts;\n    let trigger = this.getTrigger();\n    if (!trigger.hasAttribute('disabled')) {\n      if (interactionType === 'mouse') {\n        await this.user.click(trigger);\n      } else if (interactionType === 'touch') {\n        await this.user.pointer({target: trigger, keys: '[TouchA]'});\n      } else if (interactionType === 'keyboard') {\n        act(() => trigger.focus());\n        await this.user.keyboard('[Enter]');\n      }\n\n      if (this._overlayType === 'popover') {\n        await waitFor(() => {\n          if (trigger.getAttribute('aria-controls') == null) {\n            throw new Error('No aria-controls found on dialog trigger element.');\n          } else {\n            return true;\n          }\n        });\n\n        let dialogId = trigger.getAttribute('aria-controls');\n        await waitFor(() => {\n          if (!dialogId || document.getElementById(dialogId) == null) {\n            throw new Error(`Dialog with id of ${dialogId} not found in document.`);\n          } else {\n            this._dialog = document.getElementById(dialogId)!;\n            return true;\n          }\n        });\n      } else {\n        let dialog;\n        await waitFor(() => {\n          dialog = document.querySelector('[role=dialog], [role=alertdialog]');\n          if (dialog == null) {\n            throw new Error(\n              'No dialog of type role=\"dialog\" or role=\"alertdialog\" found after pressing the trigger.'\n            );\n          } else {\n            return true;\n          }\n        });\n\n        if (\n          dialog &&\n          document.activeElement !== this._trigger &&\n          dialog.contains(document.activeElement)\n        ) {\n          this._dialog = dialog;\n        } else {\n          throw new Error(\n            'New modal dialog doesnt contain the active element OR the active element is still the trigger. Uncertain if the proper modal dialog was found'\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Closes the dialog via the Escape key.\n   */\n  async close(): Promise<void> {\n    let dialog = this._dialog;\n    if (dialog) {\n      await this.user.keyboard('[Escape]');\n      await waitFor(() => {\n        if (document.contains(dialog)) {\n          throw new Error('Expected the dialog to not be in the document after closing it.');\n        } else {\n          this._dialog = undefined;\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Returns the dialog's trigger.\n   */\n  getTrigger(): HTMLElement {\n    if (!this._trigger) {\n      throw new Error('No trigger element found for dialog.');\n    }\n\n    return this._trigger;\n  }\n\n  /**\n   * Returns the dialog if present.\n   */\n  getDialog(): HTMLElement | null {\n    return this._dialog && document.contains(this._dialog) ? this._dialog : null;\n  }\n}\n"],"names":[],"version":3,"file":"dialog.cjs.map"}