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

package/dist/tabs.mjs

@@ -0,0 +1,128 @@
+import {pressElement as $5d1eca18f92ad0e6$export$6ffa3eb717517feb} from "./events.mjs";
+import {within as $im2y9$within, act as $im2y9$act} from "@testing-library/react";
+
+/*
+ * 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 $e615c34a00448a49$export$f1539bff3fc7d485 {
+    /**
+   * Set the interaction type used by the tabs tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    // TODO: This is pretty similar across most the utils, refactor to make it generic?
+    /**
+   * Returns a tab matching the specified index or text content.
+   */ findTab(opts) {
+        let { tabIndexOrText: tabIndexOrText } = opts;
+        let tab;
+        let tabs = this.tabs;
+        if (typeof tabIndexOrText === 'number') tab = tabs[tabIndexOrText];
+        else if (typeof tabIndexOrText === 'string') tab = (0, $im2y9$within)(this._tablist).getByText(tabIndexOrText).closest('[role=tab]');
+        return tab;
+    }
+    // TODO: also quite similar across more utils albeit with orientation, refactor to make generic
+    async keyboardNavigateToTab(opts) {
+        let { tab: tab, orientation: orientation = 'vertical' } = opts;
+        let tabs = this.tabs;
+        let targetIndex = tabs.indexOf(tab);
+        if (targetIndex === -1) throw new Error('Tab provided is not in the tablist');
+        if (!this._tablist.contains(document.activeElement)) {
+            let selectedTab = this.selectedTab;
+            if (selectedTab != null) (0, $im2y9$act)(()=>selectedTab.focus());
+            else (0, $im2y9$act)(()=>{
+                var _tabs_find;
+                return (_tabs_find = tabs.find((tab)=>!(tab.hasAttribute('disabled') || tab.getAttribute('aria-disabled') === 'true'))) === null || _tabs_find === void 0 ? void 0 : _tabs_find.focus();
+            });
+        }
+        let currIndex = this.tabs.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('ActiveElement is not in the tablist');
+        let arrowUp = 'ArrowUp';
+        let arrowDown = 'ArrowDown';
+        if (orientation === 'horizontal') {
+            if (this._direction === 'ltr') {
+                arrowUp = 'ArrowLeft';
+                arrowDown = 'ArrowRight';
+            } else {
+                arrowUp = 'ArrowRight';
+                arrowDown = 'ArrowLeft';
+            }
+        }
+        let movementDirection = targetIndex > currIndex ? 'down' : 'up';
+        for(let i = 0; i < Math.abs(targetIndex - currIndex); i++)await this.user.keyboard(`[${movementDirection === 'down' ? arrowDown : arrowUp}]`);
+    }
+    /**
+   * Triggers the specified tab. Defaults to using the interaction type set on the tabs tester.
+   */ async triggerTab(opts) {
+        let { tab: tab, interactionType: interactionType = this._interactionType, manualActivation: manualActivation } = opts;
+        if (typeof tab === 'string' || typeof tab === 'number') tab = this.findTab({
+            tabIndexOrText: tab
+        });
+        if (!tab) throw new Error('Target tab not found in the tablist.');
+        else if (tab.hasAttribute('disabled')) throw new Error('Target tab is disabled.');
+        if (interactionType === 'keyboard') {
+            if (document.activeElement !== this._tablist || !this._tablist.contains(document.activeElement)) (0, $im2y9$act)(()=>this._tablist.focus());
+            let tabsOrientation = this._tablist.getAttribute('aria-orientation') || 'horizontal';
+            await this.keyboardNavigateToTab({
+                tab: tab,
+                orientation: tabsOrientation
+            });
+            if (manualActivation) await this.user.keyboard('[Enter]');
+        } else await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, tab, interactionType);
+    }
+    /**
+   * Returns the tablist.
+   */ get tablist() {
+        return this._tablist;
+    }
+    /**
+   * Returns the tabpanels.
+   */ get tabpanels() {
+        let tabpanels = [];
+        for (let tab of this.tabs){
+            let controlId = tab.getAttribute('aria-controls');
+            let panel = controlId != null ? document.getElementById(controlId) : null;
+            if (panel != null) tabpanels.push(panel);
+        }
+        return tabpanels;
+    }
+    /**
+   * Returns the tabs in the tablist.
+   */ get tabs() {
+        return (0, $im2y9$within)(this.tablist).queryAllByRole('tab');
+    }
+    /**
+   * Returns the currently selected tab in the tablist if any.
+   */ get selectedTab() {
+        return this.tabs.find((tab)=>tab.getAttribute('aria-selected') === 'true') || null;
+    }
+    /**
+   * Returns the currently active tabpanel if any.
+   */ get activeTabpanel() {
+        var _this_selectedTab;
+        let activeTabpanelId = (_this_selectedTab = this.selectedTab) === null || _this_selectedTab === void 0 ? void 0 : _this_selectedTab.getAttribute('aria-controls');
+        return activeTabpanelId ? document.getElementById(activeTabpanelId) : null;
+    }
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType, direction: direction } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._direction = direction || 'ltr';
+        this._tablist = root;
+        let tablist = (0, $im2y9$within)(root).queryAllByRole('tablist');
+        if (tablist.length > 0) this._tablist = tablist[0];
+    }
+}
+
+
+export {$e615c34a00448a49$export$f1539bff3fc7d485 as TabsTester};
+//# sourceMappingURL=tabs.module.js.map

package/dist/tabs.module.js

@@ -0,0 +1,128 @@
+import {pressElement as $5d1eca18f92ad0e6$export$6ffa3eb717517feb} from "./events.module.js";
+import {within as $im2y9$within, act as $im2y9$act} from "@testing-library/react";
+
+/*
+ * 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 $e615c34a00448a49$export$f1539bff3fc7d485 {
+    /**
+   * Set the interaction type used by the tabs tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    // TODO: This is pretty similar across most the utils, refactor to make it generic?
+    /**
+   * Returns a tab matching the specified index or text content.
+   */ findTab(opts) {
+        let { tabIndexOrText: tabIndexOrText } = opts;
+        let tab;
+        let tabs = this.tabs;
+        if (typeof tabIndexOrText === 'number') tab = tabs[tabIndexOrText];
+        else if (typeof tabIndexOrText === 'string') tab = (0, $im2y9$within)(this._tablist).getByText(tabIndexOrText).closest('[role=tab]');
+        return tab;
+    }
+    // TODO: also quite similar across more utils albeit with orientation, refactor to make generic
+    async keyboardNavigateToTab(opts) {
+        let { tab: tab, orientation: orientation = 'vertical' } = opts;
+        let tabs = this.tabs;
+        let targetIndex = tabs.indexOf(tab);
+        if (targetIndex === -1) throw new Error('Tab provided is not in the tablist');
+        if (!this._tablist.contains(document.activeElement)) {
+            let selectedTab = this.selectedTab;
+            if (selectedTab != null) (0, $im2y9$act)(()=>selectedTab.focus());
+            else (0, $im2y9$act)(()=>{
+                var _tabs_find;
+                return (_tabs_find = tabs.find((tab)=>!(tab.hasAttribute('disabled') || tab.getAttribute('aria-disabled') === 'true'))) === null || _tabs_find === void 0 ? void 0 : _tabs_find.focus();
+            });
+        }
+        let currIndex = this.tabs.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('ActiveElement is not in the tablist');
+        let arrowUp = 'ArrowUp';
+        let arrowDown = 'ArrowDown';
+        if (orientation === 'horizontal') {
+            if (this._direction === 'ltr') {
+                arrowUp = 'ArrowLeft';
+                arrowDown = 'ArrowRight';
+            } else {
+                arrowUp = 'ArrowRight';
+                arrowDown = 'ArrowLeft';
+            }
+        }
+        let movementDirection = targetIndex > currIndex ? 'down' : 'up';
+        for(let i = 0; i < Math.abs(targetIndex - currIndex); i++)await this.user.keyboard(`[${movementDirection === 'down' ? arrowDown : arrowUp}]`);
+    }
+    /**
+   * Triggers the specified tab. Defaults to using the interaction type set on the tabs tester.
+   */ async triggerTab(opts) {
+        let { tab: tab, interactionType: interactionType = this._interactionType, manualActivation: manualActivation } = opts;
+        if (typeof tab === 'string' || typeof tab === 'number') tab = this.findTab({
+            tabIndexOrText: tab
+        });
+        if (!tab) throw new Error('Target tab not found in the tablist.');
+        else if (tab.hasAttribute('disabled')) throw new Error('Target tab is disabled.');
+        if (interactionType === 'keyboard') {
+            if (document.activeElement !== this._tablist || !this._tablist.contains(document.activeElement)) (0, $im2y9$act)(()=>this._tablist.focus());
+            let tabsOrientation = this._tablist.getAttribute('aria-orientation') || 'horizontal';
+            await this.keyboardNavigateToTab({
+                tab: tab,
+                orientation: tabsOrientation
+            });
+            if (manualActivation) await this.user.keyboard('[Enter]');
+        } else await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, tab, interactionType);
+    }
+    /**
+   * Returns the tablist.
+   */ get tablist() {
+        return this._tablist;
+    }
+    /**
+   * Returns the tabpanels.
+   */ get tabpanels() {
+        let tabpanels = [];
+        for (let tab of this.tabs){
+            let controlId = tab.getAttribute('aria-controls');
+            let panel = controlId != null ? document.getElementById(controlId) : null;
+            if (panel != null) tabpanels.push(panel);
+        }
+        return tabpanels;
+    }
+    /**
+   * Returns the tabs in the tablist.
+   */ get tabs() {
+        return (0, $im2y9$within)(this.tablist).queryAllByRole('tab');
+    }
+    /**
+   * Returns the currently selected tab in the tablist if any.
+   */ get selectedTab() {
+        return this.tabs.find((tab)=>tab.getAttribute('aria-selected') === 'true') || null;
+    }
+    /**
+   * Returns the currently active tabpanel if any.
+   */ get activeTabpanel() {
+        var _this_selectedTab;
+        let activeTabpanelId = (_this_selectedTab = this.selectedTab) === null || _this_selectedTab === void 0 ? void 0 : _this_selectedTab.getAttribute('aria-controls');
+        return activeTabpanelId ? document.getElementById(activeTabpanelId) : null;
+    }
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType, direction: direction } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._direction = direction || 'ltr';
+        this._tablist = root;
+        let tablist = (0, $im2y9$within)(root).queryAllByRole('tablist');
+        if (tablist.length > 0) this._tablist = tablist[0];
+    }
+}
+
+
+export {$e615c34a00448a49$export$f1539bff3fc7d485 as TabsTester};
+//# sourceMappingURL=tabs.module.js.map

package/dist/tabs.module.js.map

@@ -0,0 +1 @@
+{"mappings":";;;AAAA;;;;;;;;;;CAUC;;AAqBM,MAAM;IAmBX;;GAEC,GACD,mBAAmB,IAAiC,EAAE;QACpD,IAAI,CAAC,gBAAgB,GAAG;IAC1B;IAEA,mFAAmF;IACnF;;GAEC,GACD,QAAQ,IAAuC,EAAe;QAC5D,IAAI,kBACF,cAAc,EACf,GAAG;QAEJ,IAAI;QACJ,IAAI,OAAO,IAAI,CAAC,IAAI;QACpB,IAAI,OAAO,mBAAmB,UAC5B,MAAM,IAAI,CAAC,eAAe;aACrB,IAAI,OAAO,mBAAmB,UACnC,MAAO,CAAA,GAAA,aAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,gBAAgB,OAAO,CAAC;QAGjE,OAAO;IACT;IAEA,+FAA+F;IAC/F,MAAc,sBAAsB,IAAmD,EAAE;QACvF,IAAI,OAAC,GAAG,eAAE,cAAc,YAAW,GAAG;QACtC,IAAI,OAAO,IAAI,CAAC,IAAI;QACpB,IAAI,cAAc,KAAK,OAAO,CAAC;QAC/B,IAAI,gBAAgB,IAClB,MAAM,IAAI,MAAM;QAGlB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,aAAa,GAAG;YACnD,IAAI,cAAc,IAAI,CAAC,WAAW;YAClC,IAAI,eAAe,MACjB,CAAA,GAAA,UAAE,EAAE,IAAM,YAAY,KAAK;iBAE3B,CAAA,GAAA,UAAE,EAAE;oBAAM;wBAAA,aAAA,KAAK,IAAI,CAAC,CAAA,MAAO,CAAE,CAAA,IAAI,YAAY,CAAC,eAAe,IAAI,YAAY,CAAC,qBAAqB,MAAK,gBAA9F,iCAAA,WAAmG,KAAK;;QAEtH;QAEA,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,aAAa;QACxD,IAAI,cAAc,IAChB,MAAM,IAAI,MAAM;QAGlB,IAAI,UAAU;QACd,IAAI,YAAY;QAChB,IAAI,gBAAgB;YAClB,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO;gBAC7B,UAAU;gBACV,YAAY;YACd,OAAO;gBACL,UAAU;gBACV,YAAY;YACd;;QAGF,IAAI,oBAAoB,cAAc,YAAY,SAAS;QAC3D,IAAK,IAAI,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,cAAc,YAAY,IACrD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,sBAAsB,SAAS,YAAY,QAAQ,CAAC,CAAC;IAEtF;IAEA;;GAEC,GACD,MAAM,WAAW,IAAuB,EAAE;QACxC,IAAI,OACF,GAAG,mBACH,kBAAkB,IAAI,CAAC,gBAAgB,oBACvC,gBAAgB,EACjB,GAAG;QAEJ,IAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAC5C,MAAM,IAAI,CAAC,OAAO,CAAC;YAAC,gBAAgB;QAAG;QAGzC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM;aACX,IAAI,IAAI,YAAY,CAAC,aAC1B,MAAM,IAAI,MAAM;QAGlB,IAAI,oBAAoB,YAAY;YAClC,IAAI,SAAS,aAAa,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,aAAa,GAC5F,CAAA,GAAA,UAAE,EAAE,IAAM,IAAI,CAAC,QAAQ,CAAC,KAAK;YAG/B,IAAI,kBAAkB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,uBAAuB;YACxE,MAAM,IAAI,CAAC,qBAAqB,CAAC;qBAAC;gBAAK,aAAa;YAA8B;YAClF,IAAI,kBACF,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAE7B,OACE,MAAM,CAAA,GAAA,yCAAW,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK;IAEvC;IAEA;;GAEC,GACD,IAAI,UAAuB;QACzB,OAAO,IAAI,CAAC,QAAQ;IACtB;IAEA;;GAEC,GACD,IAAI,YAA2B;QAC7B,IAAI,YAAY,EAAE;QAClB,KAAK,IAAI,OAAO,IAAI,CAAC,IAAI,CAAE;YACzB,IAAI,YAAY,IAAI,YAAY,CAAC;YACjC,IAAI,QAAQ,aAAa,OAAO,SAAS,cAAc,CAAC,aAAa;YACrE,IAAI,SAAS,MACX,UAAU,IAAI,CAAC;QAEnB;QAEA,OAAO;IACT;IAEA;;GAEC,GACD,IAAI,OAAsB;QACxB,OAAO,CAAA,GAAA,aAAK,EAAE,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC;IAC7C;IAEA;;GAEC,GACD,IAAI,cAAkC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,MAAO,IAAI,YAAY,CAAC,qBAAqB,WAAW;IAChF;IAEA;;GAEC,GACD,IAAI,iBAAqC;YAChB;QAAvB,IAAI,oBAAmB,oBAAA,IAAI,CAAC,WAAW,cAAhB,wCAAA,kBAAkB,YAAY,CAAC;QACtD,OAAO,mBAAmB,SAAS,cAAc,CAAC,oBAAoB;IACxE;IA/JA,YAAY,IAAoB,CAAE;QAChC,IAAI,QAAC,IAAI,QAAE,IAAI,mBAAE,eAAe,aAAE,SAAS,EAAC,GAAG;QAC/C,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,gBAAgB,GAAG,mBAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,aAAa;QAE/B,IAAI,CAAC,QAAQ,GAAG;QAChB,IAAI,UAAU,CAAA,GAAA,aAAK,EAAE,MAAM,cAAc,CAAC;QAC1C,IAAI,QAAQ,MAAM,GAAG,GACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,EAAE;IAE9B;AAqJF","sources":["packages/@react-aria/test-utils/src/tabs.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, within} from '@testing-library/react';\nimport {Direction, Orientation, TabsTesterOpts, UserOpts} from './types';\nimport {pressElement} from './events';\n\ninterface TriggerTabOptions {\n  /**\n   * What interaction type to use when triggering a tab. Defaults to the interaction type set on the tester.\n   */\n  interactionType?: UserOpts['interactionType'],\n  /**\n   * The index, text, or node of the tab to toggle selection for.\n   */\n  tab: number | string | HTMLElement,\n  /**\n   * Whether the tab needs to be activated manually rather than on focus.\n   */\n  manualActivation?: boolean\n}\n\nexport class TabsTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _tablist: HTMLElement;\n  private _direction: Direction;\n\n  constructor(opts: TabsTesterOpts) {\n    let {root, user, interactionType, direction} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n    this._direction = direction || 'ltr';\n\n    this._tablist = root;\n    let tablist = within(root).queryAllByRole('tablist');\n    if (tablist.length > 0) {\n      this._tablist = tablist[0];\n    }\n  }\n\n  /**\n   * Set the interaction type used by the tabs tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']) {\n    this._interactionType = type;\n  }\n\n  // TODO: This is pretty similar across most the utils, refactor to make it generic?\n  /**\n   * Returns a tab matching the specified index or text content.\n   */\n  findTab(opts: {tabIndexOrText: number | string}): HTMLElement {\n    let {\n      tabIndexOrText\n    } = opts;\n\n    let tab;\n    let tabs = this.tabs;\n    if (typeof tabIndexOrText === 'number') {\n      tab = tabs[tabIndexOrText];\n    } else if (typeof tabIndexOrText === 'string') {\n      tab = (within(this._tablist).getByText(tabIndexOrText).closest('[role=tab]'))! as HTMLElement;\n    }\n\n    return tab;\n  }\n\n  // TODO: also quite similar across more utils albeit with orientation, refactor to make generic\n  private async keyboardNavigateToTab(opts: {tab: HTMLElement, orientation?: Orientation}) {\n    let {tab, orientation = 'vertical'} = opts;\n    let tabs = this.tabs;\n    let targetIndex = tabs.indexOf(tab);\n    if (targetIndex === -1) {\n      throw new Error('Tab provided is not in the tablist');\n    }\n\n    if (!this._tablist.contains(document.activeElement)) {\n      let selectedTab = this.selectedTab;\n      if (selectedTab != null) {\n        act(() => selectedTab.focus());\n      } else {\n        act(() => tabs.find(tab => !(tab.hasAttribute('disabled') || tab.getAttribute('aria-disabled') === 'true'))?.focus());\n      }\n    }\n\n    let currIndex = this.tabs.indexOf(document.activeElement as HTMLElement);\n    if (currIndex === -1) {\n      throw new Error('ActiveElement is not in the tablist');\n    }\n\n    let arrowUp = 'ArrowUp';\n    let arrowDown = 'ArrowDown';\n    if (orientation === 'horizontal') {\n      if (this._direction === 'ltr') {\n        arrowUp = 'ArrowLeft';\n        arrowDown = 'ArrowRight';\n      } else {\n        arrowUp = 'ArrowRight';\n        arrowDown = 'ArrowLeft';\n      }\n    }\n\n    let movementDirection = targetIndex > currIndex ? 'down' : 'up';\n    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {\n      await this.user.keyboard(`[${movementDirection === 'down' ? arrowDown : arrowUp}]`);\n    }\n  };\n\n  /**\n   * Triggers the specified tab. Defaults to using the interaction type set on the tabs tester.\n   */\n  async triggerTab(opts: TriggerTabOptions) {\n    let {\n      tab,\n      interactionType = this._interactionType,\n      manualActivation\n    } = opts;\n\n    if (typeof tab === 'string' || typeof tab === 'number') {\n      tab = this.findTab({tabIndexOrText: tab});\n    }\n\n    if (!tab) {\n      throw new Error('Target tab not found in the tablist.');\n    } else if (tab.hasAttribute('disabled')) {\n      throw new Error('Target tab is disabled.');\n    }\n\n    if (interactionType === 'keyboard') {\n      if (document.activeElement !== this._tablist || !this._tablist.contains(document.activeElement)) {\n        act(() => this._tablist.focus());\n      }\n\n      let tabsOrientation = this._tablist.getAttribute('aria-orientation') || 'horizontal';\n      await this.keyboardNavigateToTab({tab, orientation: tabsOrientation as Orientation});\n      if (manualActivation) {\n        await this.user.keyboard('[Enter]');\n      }\n    } else {\n      await pressElement(this.user, tab, interactionType);\n    }\n  }\n\n  /**\n   * Returns the tablist.\n   */\n  get tablist(): HTMLElement {\n    return this._tablist;\n  }\n\n  /**\n   * Returns the tabpanels.\n   */\n  get tabpanels(): HTMLElement[] {\n    let tabpanels = [] as HTMLElement[];\n    for (let tab of this.tabs) {\n      let controlId = tab.getAttribute('aria-controls');\n      let panel = controlId != null ? document.getElementById(controlId) : null;\n      if (panel != null) {\n        tabpanels.push(panel);\n      }\n    }\n\n    return tabpanels;\n  }\n\n  /**\n   * Returns the tabs in the tablist.\n   */\n  get tabs(): HTMLElement[] {\n    return within(this.tablist).queryAllByRole('tab');\n  }\n\n  /**\n   * Returns the currently selected tab in the tablist if any.\n   */\n  get selectedTab(): HTMLElement | null {\n    return this.tabs.find(tab => tab.getAttribute('aria-selected') === 'true') || null;\n  }\n\n  /**\n   * Returns the currently active tabpanel if any.\n   */\n  get activeTabpanel(): HTMLElement | null {\n    let activeTabpanelId = this.selectedTab?.getAttribute('aria-controls');\n    return activeTabpanelId ? document.getElementById(activeTabpanelId) : null;\n  }\n}\n"],"names":[],"version":3,"file":"tabs.module.js.map"}

package/dist/tree.main.js

@@ -0,0 +1,165 @@
+var $5a8bfe1663b8366d$exports = require("./events.main.js");
+var $cVFA5$testinglibraryreact = require("@testing-library/react");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "TreeTester", () => $9c221bde173322ba$export$4445864b14128396);
+/*
+ * 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 $9c221bde173322ba$export$4445864b14128396 {
+    /**
+   * Set the interaction type used by the tree tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Returns a row matching the specified index or text content.
+   */ findRow(opts) {
+        let { rowIndexOrText: rowIndexOrText } = opts;
+        let row;
+        if (typeof rowIndexOrText === 'number') row = this.rows[rowIndexOrText];
+        else if (typeof rowIndexOrText === 'string') row = (0, $cVFA5$testinglibraryreact.within)(this.tree).getByText(rowIndexOrText).closest('[role=row]');
+        return row;
+    }
+    // TODO: RTL
+    async keyboardNavigateToRow(opts) {
+        let { row: row } = opts;
+        let rows = this.rows;
+        let targetIndex = rows.indexOf(row);
+        if (targetIndex === -1) throw new Error('Option provided is not in the tree');
+        if (document.activeElement === this.tree) await this.user.keyboard('[ArrowDown]');
+        else if (this._tree.contains(document.activeElement) && document.activeElement.getAttribute('role') !== 'row') do await this.user.keyboard('[ArrowLeft]');
+        while (document.activeElement.getAttribute('role') !== 'row');
+        let currIndex = rows.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('ActiveElement is not in the tree');
+        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 for the specified tree row. Defaults to using the interaction type set on the tree 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 tree.');
+        let rowCheckbox = (0, $cVFA5$testinglibraryreact.within)(row).queryByRole('checkbox');
+        // TODO: we early return here because the checkbox can't be keyboard navigated to if the row is disabled usually
+        // but we may to check for disabledBehavior (aka if the disable row gets skipped when keyboard navigating or not)
+        if (interactionType === 'keyboard' && ((rowCheckbox === null || rowCheckbox === void 0 ? void 0 : rowCheckbox.getAttribute('disabled')) === '' || (row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true')) return;
+        // this would be better than the check to do nothing in events.ts
+        // also, it'd be good to be able to trigger selection on the row instead of having to go to the checkbox directly
+        if (interactionType === 'keyboard' && !checkboxSelection) {
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            await this.user.keyboard('{Space}');
+            return;
+        }
+        if (rowCheckbox && checkboxSelection) await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, rowCheckbox, interactionType);
+        else {
+            let cell = (0, $cVFA5$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 expansion for the specified tree row. Defaults to using the interaction type set on the tree tester.
+   */ async toggleRowExpansion(opts) {
+        let { row: row, interactionType: interactionType = this._interactionType } = opts;
+        if (!this.tree.contains(document.activeElement)) await (0, $cVFA5$testinglibraryreact.act)(async ()=>{
+            this.tree.focus();
+        });
+        if (typeof row === 'string' || typeof row === 'number') row = this.findRow({
+            rowIndexOrText: row
+        });
+        if (!row) throw new Error('Target row not found in the tree.');
+        else if (row.getAttribute('aria-expanded') == null) throw new Error('Target row is not expandable.');
+        if (interactionType === 'mouse' || interactionType === 'touch') {
+            let rowExpander = (0, $cVFA5$testinglibraryreact.within)(row).getAllByRole('button')[0]; // what happens if the button is not first? how can we differentiate?
+            await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, rowExpander, interactionType);
+        } else if (interactionType === 'keyboard') {
+            if ((row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true') return;
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            if (row.getAttribute('aria-expanded') === 'true') await this.user.keyboard('[ArrowLeft]');
+            else await this.user.keyboard('[ArrowRight]');
+        }
+    }
+    /**
+   * Triggers the action for the specified tree row. Defaults to using the interaction type set on the tree 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 tree.');
+        if (needsDoubleClick) await this.user.dblClick(row);
+        else if (interactionType === 'keyboard') {
+            if ((row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true') return;
+            if (document.activeElement !== this._tree || !this._tree.contains(document.activeElement)) (0, $cVFA5$testinglibraryreact.act)(()=>this._tree.focus());
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            await this.user.keyboard('[Enter]');
+        } else await (0, $5a8bfe1663b8366d$exports.pressElement)(this.user, row, interactionType);
+    }
+    /**
+   * Returns the tree.
+   */ get tree() {
+        return this._tree;
+    }
+    /**
+   * Returns the tree's rows if any.
+   */ get rows() {
+        var _this;
+        return (0, $cVFA5$testinglibraryreact.within)((_this = this) === null || _this === void 0 ? void 0 : _this.tree).queryAllByRole('row');
+    }
+    /**
+   * Returns the tree's selected rows if any.
+   */ get selectedRows() {
+        return this.rows.filter((row)=>row.getAttribute('aria-selected') === 'true');
+    }
+    /**
+   * Returns the tree's cells if any. Can be filtered against a specific row if provided via `element`.
+   */ cells(opts = {}) {
+        let { element: element = this.tree } = opts;
+        return (0, $cVFA5$testinglibraryreact.within)(element).queryAllByRole('gridcell');
+    }
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType, advanceTimer: advanceTimer } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._advanceTimer = advanceTimer;
+        this._tree = root;
+        // TODO: should all helpers do this?
+        let tree = (0, $cVFA5$testinglibraryreact.within)(root).queryByRole('treegrid');
+        if (root.getAttribute('role') !== 'treegrid' && tree) this._tree = tree;
+    }
+}
+
+
+//# sourceMappingURL=tree.main.js.map

package/dist/tree.main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;AAAA;;;;;;;;;;CAUC;;AAWM,MAAM;IAmBX;;GAEC,GACD,mBAAmB,IAAiC,EAAE;QACpD,IAAI,CAAC,gBAAgB,GAAG;IAC1B;IAEA;;GAEC,GACD,QAAQ,IAAuC,EAAe;QAC5D,IAAI,kBACF,cAAc,EACf,GAAG;QAEJ,IAAI;QACJ,IAAI,OAAO,mBAAmB,UAC5B,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe;aAC1B,IAAI,OAAO,mBAAmB,UACnC,MAAO,CAAA,GAAA,iCAAK,EAAE,IAAI,CAAC,IAAI,EAAG,SAAS,CAAC,gBAAgB,OAAO,CAAC;QAG9D,OAAO;IACT;IAEA,YAAY;IACZ,MAAc,sBAAsB,IAAwB,EAAE;QAC5D,IAAI,OAAC,GAAG,EAAC,GAAG;QACZ,IAAI,OAAO,IAAI,CAAC,IAAI;QACpB,IAAI,cAAc,KAAK,OAAO,CAAC;QAC/B,IAAI,gBAAgB,IAClB,MAAM,IAAI,MAAM;QAElB,IAAI,SAAS,aAAa,KAAK,IAAI,CAAC,IAAI,EACtC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;aACpB,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,aAAa,KAAK,SAAS,aAAa,CAAE,YAAY,CAAC,YAAY,OACzG,GACE,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;eAClB,SAAS,aAAa,CAAE,YAAY,CAAC,YAAY,OAAO;QAEnE,IAAI,YAAY,KAAK,OAAO,CAAC,SAAS,aAAa;QACnD,IAAI,cAAc,IAChB,MAAM,IAAI,MAAM;QAElB,IAAI,YAAY,cAAc,YAAY,SAAS;QAEnD,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;;GAEC,GACD,MAAM,mBAAmB,IAAuB,EAAE;QAChD,IAAI,OACF,GAAG,kBACH,cAAc,qBACd,oBAAoB,uBACpB,kBAAkB,IAAI,CAAC,gBAAgB,EACxC,GAAG;QAEJ,IAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAC5C,MAAM,IAAI,CAAC,OAAO,CAAC;YAAC,gBAAgB;QAAG;QAGzC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM;QAGlB,IAAI,cAAc,CAAA,GAAA,iCAAK,EAAE,KAAK,WAAW,CAAC;QAE1C,gHAAgH;QAChH,iHAAiH;QACjH,IAAI,oBAAoB,cAAe,CAAA,CAAA,wBAAA,kCAAA,YAAa,YAAY,CAAC,iBAAgB,MAAM,CAAA,gBAAA,0BAAA,IAAK,YAAY,CAAC,sBAAqB,MAAK,GACjI;QAGF,iEAAiE;QACjE,iHAAiH;QACjH,IAAI,oBAAoB,cAAc,CAAC,mBAAmB;YACxD,MAAM,IAAI,CAAC,qBAAqB,CAAC;qBAAC;YAAG;YACrC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACzB;QACF;QACA,IAAI,eAAe,mBACjB,MAAM,CAAA,GAAA,sCAAW,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa;aACtC;YACL,IAAI,OAAO,CAAA,GAAA,iCAAK,EAAE,KAAK,YAAY,CAAC,WAAW,CAAC,EAAE;YAClD,IAAI,kBAAkB,oBAAoB,SAAS;gBACjD,IAAI,IAAI,CAAC,aAAa,IAAI,MACxB,MAAM,IAAI,MAAM;gBAGlB,mFAAmF;gBACnF,MAAM,CAAA,GAAA,0CAAe,EAAE;oBAAC,SAAS;oBAAM,cAAc,IAAI,CAAC,aAAa;oBAAE,aAAa;wBAAC,aAAa;oBAAO;gBAAC;YAC9G,OACE,MAAM,CAAA,GAAA,sCAAW,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM;QAExC;IACF;IAEA;;GAEC,GACD,MAAM,mBAAmB,IAA6B,EAAE;QACtD,IAAI,OACF,GAAG,mBACH,kBAAkB,IAAI,CAAC,gBAAgB,EACxC,GAAG;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,aAAa,GAC5C,MAAM,CAAA,GAAA,8BAAE,EAAE;YACR,IAAI,CAAC,IAAI,CAAC,KAAK;QACjB;QAGF,IAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAC5C,MAAM,IAAI,CAAC,OAAO,CAAC;YAAC,gBAAgB;QAAG;QAGzC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM;aACX,IAAI,IAAI,YAAY,CAAC,oBAAoB,MAC9C,MAAM,IAAI,MAAM;QAGlB,IAAI,oBAAoB,WAAW,oBAAoB,SAAS;YAC9D,IAAI,cAAc,CAAA,GAAA,iCAAK,EAAE,KAAK,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,qEAAqE;YAC9H,MAAM,CAAA,GAAA,sCAAW,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa;QAC7C,OAAO,IAAI,oBAAoB,YAAY;YACzC,IAAI,CAAA,gBAAA,0BAAA,IAAK,YAAY,CAAC,sBAAqB,QACzC;YAGF,MAAM,IAAI,CAAC,qBAAqB,CAAC;qBAAC;YAAG;YACrC,IAAI,IAAI,YAAY,CAAC,qBAAqB,QACxC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;iBAEzB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAE7B;IACF;IAEA;;GAEC,GACD,MAAM,iBAAiB,IAAuB,EAAE;QAC9C,IAAI,OACF,GAAG,oBACH,gBAAgB,mBAChB,kBAAkB,IAAI,CAAC,gBAAgB,EACxC,GAAG;QAEJ,IAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAC5C,MAAM,IAAI,CAAC,OAAO,CAAC;YAAC,gBAAgB;QAAG;QAGzC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM;QAGlB,IAAI,kBACF,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;aACpB,IAAI,oBAAoB,YAAY;YACzC,IAAI,CAAA,gBAAA,0BAAA,IAAK,YAAY,CAAC,sBAAqB,QACzC;YAGF,IAAI,SAAS,aAAa,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,aAAa,GACtF,CAAA,GAAA,8BAAE,EAAE,IAAM,IAAI,CAAC,KAAK,CAAC,KAAK;YAG5B,MAAM,IAAI,CAAC,qBAAqB,CAAC;qBAAC;YAAG;YACrC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC3B,OACE,MAAM,CAAA,GAAA,sCAAW,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK;IAEvC;IAEA;;GAEC,GACD,IAAI,OAAqB;QACvB,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA;;GAEC,GACD,IAAI,OAAsB;YACV;QAAd,OAAO,CAAA,GAAA,iCAAK,GAAE,QAAA,IAAI,cAAJ,4BAAA,MAAM,IAAI,EAAE,cAAc,CAAC;IAC3C;IAEA;;GAEC,GACD,IAAI,eAA8B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA,MAAO,IAAI,YAAY,CAAC,qBAAqB;IACvE;IAEA;;GAEC,GACD,MAAM,OAAgC,CAAC,CAAC,EAAiB;QACvD,IAAI,WAAC,UAAU,IAAI,CAAC,IAAI,EAAC,GAAG;QAC5B,OAAO,CAAA,GAAA,iCAAK,EAAE,SAAS,cAAc,CAAC;IACxC;IA3NA,YAAY,IAAoB,CAAE;QAChC,IAAI,QAAC,IAAI,QAAE,IAAI,mBAAE,eAAe,gBAAE,YAAY,EAAC,GAAG;QAClD,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,gBAAgB,GAAG,mBAAmB;QAC3C,IAAI,CAAC,aAAa,GAAG;QACrB,IAAI,CAAC,KAAK,GAAG;QACb,oCAAoC;QACpC,IAAI,OAAO,CAAA,GAAA,iCAAK,EAAE,MAAM,WAAW,CAAC;QACpC,IAAI,KAAK,YAAY,CAAC,YAAY,cAAc,MAC9C,IAAI,CAAC,KAAK,GAAG;IAEjB;AAiNF","sources":["packages/@react-aria/test-utils/src/tree.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, within} from '@testing-library/react';\nimport {BaseGridRowInteractionOpts, GridRowActionOpts, ToggleGridRowOpts, TreeTesterOpts, UserOpts} from './types';\nimport {pressElement, triggerLongPress} from './events';\n\ninterface TreeToggleExpansionOpts extends BaseGridRowInteractionOpts {}\ninterface TreeToggleRowOpts extends ToggleGridRowOpts {}\ninterface TreeRowActionOpts extends GridRowActionOpts {}\n\n// TODO: this ended up being pretty much the same as gridlist, refactor so it extends from gridlist\nexport class TreeTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _advanceTimer: UserOpts['advanceTimer'];\n  private _tree: HTMLElement;\n\n  constructor(opts: TreeTesterOpts) {\n    let {root, user, interactionType, advanceTimer} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n    this._advanceTimer = advanceTimer;\n    this._tree = root;\n    // TODO: should all helpers do this?\n    let tree = within(root).queryByRole('treegrid');\n    if (root.getAttribute('role') !== 'treegrid' && tree) {\n      this._tree = tree;\n    }\n  }\n\n  /**\n   * Set the interaction type used by the tree tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']) {\n    this._interactionType = type;\n  };\n\n  /**\n   * Returns a row matching the specified index or text content.\n   */\n  findRow(opts: {rowIndexOrText: number | string}): HTMLElement {\n    let {\n      rowIndexOrText\n    } = opts;\n\n    let row;\n    if (typeof rowIndexOrText === 'number') {\n      row = this.rows[rowIndexOrText];\n    } else if (typeof rowIndexOrText === 'string') {\n      row = (within(this.tree!).getByText(rowIndexOrText).closest('[role=row]'))! as HTMLElement;\n    }\n\n    return row;\n  }\n\n  // TODO: RTL\n  private async keyboardNavigateToRow(opts: {row: HTMLElement}) {\n    let {row} = opts;\n    let rows = this.rows;\n    let targetIndex = rows.indexOf(row);\n    if (targetIndex === -1) {\n      throw new Error('Option provided is not in the tree');\n    }\n    if (document.activeElement === this.tree) {\n      await this.user.keyboard('[ArrowDown]');\n    } else if (this._tree.contains(document.activeElement) && document.activeElement!.getAttribute('role') !== 'row') {\n      do {\n        await this.user.keyboard('[ArrowLeft]');\n      } while (document.activeElement!.getAttribute('role') !== 'row');\n    }\n    let currIndex = rows.indexOf(document.activeElement as HTMLElement);\n    if (currIndex === -1) {\n      throw new Error('ActiveElement is not in the tree');\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   * Toggles the selection for the specified tree row. Defaults to using the interaction type set on the tree tester.\n   */\n  async toggleRowSelection(opts: TreeToggleRowOpts) {\n    let {\n      row,\n      needsLongPress,\n      checkboxSelection = true,\n      interactionType = this._interactionType\n    } = opts;\n\n    if (typeof row === 'string' || typeof row === 'number') {\n      row = this.findRow({rowIndexOrText: row});\n    }\n\n    if (!row) {\n      throw new Error('Target row not found in the tree.');\n    }\n\n    let rowCheckbox = within(row).queryByRole('checkbox');\n\n    // TODO: we early return here because the checkbox can't be keyboard navigated to if the row is disabled usually\n    // but we may to check for disabledBehavior (aka if the disable row gets skipped when keyboard navigating or not)\n    if (interactionType === 'keyboard' && (rowCheckbox?.getAttribute('disabled') === '' || row?.getAttribute('aria-disabled') === 'true')) {\n      return;\n    }\n\n    // this would be better than the check to do nothing in events.ts\n    // also, it'd be good to be able to trigger selection on the row instead of having to go to the checkbox directly\n    if (interactionType === 'keyboard' && !checkboxSelection) {\n      await this.keyboardNavigateToRow({row});\n      await this.user.keyboard('{Space}');\n      return;\n    }\n    if (rowCheckbox && checkboxSelection) {\n      await pressElement(this.user, rowCheckbox, interactionType);\n    } else {\n      let cell = within(row).getAllByRole('gridcell')[0];\n      if (needsLongPress && interactionType === 'touch') {\n        if (this._advanceTimer == null) {\n          throw new Error('No advanceTimers provided for long press.');\n        }\n\n        // Note that long press interactions with rows is strictly touch only for grid rows\n        await triggerLongPress({element: cell, advanceTimer: this._advanceTimer, pointerOpts: {pointerType: 'touch'}});\n      } else {\n        await pressElement(this.user, cell, interactionType);\n      }\n    }\n  };\n\n  /**\n   * Toggles the expansion for the specified tree row. Defaults to using the interaction type set on the tree tester.\n   */\n  async toggleRowExpansion(opts: TreeToggleExpansionOpts) {\n    let {\n      row,\n      interactionType = this._interactionType\n    } = opts;\n    if (!this.tree.contains(document.activeElement)) {\n      await act(async () => {\n        this.tree.focus();\n      });\n    }\n\n    if (typeof row === 'string' || typeof row === 'number') {\n      row = this.findRow({rowIndexOrText: row});\n    }\n\n    if (!row) {\n      throw new Error('Target row not found in the tree.');\n    } else if (row.getAttribute('aria-expanded') == null) {\n      throw new Error('Target row is not expandable.');\n    }\n\n    if (interactionType === 'mouse' || interactionType === 'touch') {\n      let rowExpander = within(row).getAllByRole('button')[0]; // what happens if the button is not first? how can we differentiate?\n      await pressElement(this.user, rowExpander, interactionType);\n    } else if (interactionType === 'keyboard') {\n      if (row?.getAttribute('aria-disabled') === 'true') {\n        return;\n      }\n\n      await this.keyboardNavigateToRow({row});\n      if (row.getAttribute('aria-expanded') === 'true') {\n        await this.user.keyboard('[ArrowLeft]');\n      } else {\n        await this.user.keyboard('[ArrowRight]');\n      }\n    }\n  };\n\n  /**\n   * Triggers the action for the specified tree row. Defaults to using the interaction type set on the tree tester.\n   */\n  async triggerRowAction(opts: TreeRowActionOpts) {\n    let {\n      row,\n      needsDoubleClick,\n      interactionType = this._interactionType\n    } = opts;\n\n    if (typeof row === 'string' || typeof row === 'number') {\n      row = this.findRow({rowIndexOrText: row});\n    }\n\n    if (!row) {\n      throw new Error('Target row not found in the tree.');\n    }\n\n    if (needsDoubleClick) {\n      await this.user.dblClick(row);\n    } else if (interactionType === 'keyboard') {\n      if (row?.getAttribute('aria-disabled') === 'true') {\n        return;\n      }\n\n      if (document.activeElement !== this._tree || !this._tree.contains(document.activeElement)) {\n        act(() => this._tree.focus());\n      }\n\n      await this.keyboardNavigateToRow({row});\n      await this.user.keyboard('[Enter]');\n    } else {\n      await pressElement(this.user, row, interactionType);\n    }\n  };\n\n  /**\n   * Returns the tree.\n   */\n  get tree():  HTMLElement {\n    return this._tree;\n  }\n\n  /**\n   * Returns the tree's rows if any.\n   */\n  get rows(): HTMLElement[] {\n    return within(this?.tree).queryAllByRole('row');\n  }\n\n  /**\n   * Returns the tree's selected rows if any.\n   */\n  get selectedRows(): HTMLElement[] {\n    return this.rows.filter(row => row.getAttribute('aria-selected') === 'true');\n  }\n\n  /**\n   * Returns the tree's cells if any. Can be filtered against a specific row if provided via `element`.\n   */\n  cells(opts: {element?: HTMLElement} = {}): HTMLElement[] {\n    let {element = this.tree} = opts;\n    return within(element).queryAllByRole('gridcell');\n  }\n}\n"],"names":[],"version":3,"file":"tree.main.js.map"}

package/dist/tree.mjs

@@ -0,0 +1,160 @@
+import {pressElement as $5d1eca18f92ad0e6$export$6ffa3eb717517feb, triggerLongPress as $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b} from "./events.mjs";
+import {within as $3mnbZ$within, act as $3mnbZ$act} from "@testing-library/react";
+
+/*
+ * 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 $962758aa2f16f1a4$export$4445864b14128396 {
+    /**
+   * Set the interaction type used by the tree tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Returns a row matching the specified index or text content.
+   */ findRow(opts) {
+        let { rowIndexOrText: rowIndexOrText } = opts;
+        let row;
+        if (typeof rowIndexOrText === 'number') row = this.rows[rowIndexOrText];
+        else if (typeof rowIndexOrText === 'string') row = (0, $3mnbZ$within)(this.tree).getByText(rowIndexOrText).closest('[role=row]');
+        return row;
+    }
+    // TODO: RTL
+    async keyboardNavigateToRow(opts) {
+        let { row: row } = opts;
+        let rows = this.rows;
+        let targetIndex = rows.indexOf(row);
+        if (targetIndex === -1) throw new Error('Option provided is not in the tree');
+        if (document.activeElement === this.tree) await this.user.keyboard('[ArrowDown]');
+        else if (this._tree.contains(document.activeElement) && document.activeElement.getAttribute('role') !== 'row') do await this.user.keyboard('[ArrowLeft]');
+        while (document.activeElement.getAttribute('role') !== 'row');
+        let currIndex = rows.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('ActiveElement is not in the tree');
+        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 for the specified tree row. Defaults to using the interaction type set on the tree 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 tree.');
+        let rowCheckbox = (0, $3mnbZ$within)(row).queryByRole('checkbox');
+        // TODO: we early return here because the checkbox can't be keyboard navigated to if the row is disabled usually
+        // but we may to check for disabledBehavior (aka if the disable row gets skipped when keyboard navigating or not)
+        if (interactionType === 'keyboard' && ((rowCheckbox === null || rowCheckbox === void 0 ? void 0 : rowCheckbox.getAttribute('disabled')) === '' || (row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true')) return;
+        // this would be better than the check to do nothing in events.ts
+        // also, it'd be good to be able to trigger selection on the row instead of having to go to the checkbox directly
+        if (interactionType === 'keyboard' && !checkboxSelection) {
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            await this.user.keyboard('{Space}');
+            return;
+        }
+        if (rowCheckbox && checkboxSelection) await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, rowCheckbox, interactionType);
+        else {
+            let cell = (0, $3mnbZ$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, $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b)({
+                    element: cell,
+                    advanceTimer: this._advanceTimer,
+                    pointerOpts: {
+                        pointerType: 'touch'
+                    }
+                });
+            } else await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, cell, interactionType);
+        }
+    }
+    /**
+   * Toggles the expansion for the specified tree row. Defaults to using the interaction type set on the tree tester.
+   */ async toggleRowExpansion(opts) {
+        let { row: row, interactionType: interactionType = this._interactionType } = opts;
+        if (!this.tree.contains(document.activeElement)) await (0, $3mnbZ$act)(async ()=>{
+            this.tree.focus();
+        });
+        if (typeof row === 'string' || typeof row === 'number') row = this.findRow({
+            rowIndexOrText: row
+        });
+        if (!row) throw new Error('Target row not found in the tree.');
+        else if (row.getAttribute('aria-expanded') == null) throw new Error('Target row is not expandable.');
+        if (interactionType === 'mouse' || interactionType === 'touch') {
+            let rowExpander = (0, $3mnbZ$within)(row).getAllByRole('button')[0]; // what happens if the button is not first? how can we differentiate?
+            await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, rowExpander, interactionType);
+        } else if (interactionType === 'keyboard') {
+            if ((row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true') return;
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            if (row.getAttribute('aria-expanded') === 'true') await this.user.keyboard('[ArrowLeft]');
+            else await this.user.keyboard('[ArrowRight]');
+        }
+    }
+    /**
+   * Triggers the action for the specified tree row. Defaults to using the interaction type set on the tree 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 tree.');
+        if (needsDoubleClick) await this.user.dblClick(row);
+        else if (interactionType === 'keyboard') {
+            if ((row === null || row === void 0 ? void 0 : row.getAttribute('aria-disabled')) === 'true') return;
+            if (document.activeElement !== this._tree || !this._tree.contains(document.activeElement)) (0, $3mnbZ$act)(()=>this._tree.focus());
+            await this.keyboardNavigateToRow({
+                row: row
+            });
+            await this.user.keyboard('[Enter]');
+        } else await (0, $5d1eca18f92ad0e6$export$6ffa3eb717517feb)(this.user, row, interactionType);
+    }
+    /**
+   * Returns the tree.
+   */ get tree() {
+        return this._tree;
+    }
+    /**
+   * Returns the tree's rows if any.
+   */ get rows() {
+        var _this;
+        return (0, $3mnbZ$within)((_this = this) === null || _this === void 0 ? void 0 : _this.tree).queryAllByRole('row');
+    }
+    /**
+   * Returns the tree's selected rows if any.
+   */ get selectedRows() {
+        return this.rows.filter((row)=>row.getAttribute('aria-selected') === 'true');
+    }
+    /**
+   * Returns the tree's cells if any. Can be filtered against a specific row if provided via `element`.
+   */ cells(opts = {}) {
+        let { element: element = this.tree } = opts;
+        return (0, $3mnbZ$within)(element).queryAllByRole('gridcell');
+    }
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType, advanceTimer: advanceTimer } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._advanceTimer = advanceTimer;
+        this._tree = root;
+        // TODO: should all helpers do this?
+        let tree = (0, $3mnbZ$within)(root).queryByRole('treegrid');
+        if (root.getAttribute('role') !== 'treegrid' && tree) this._tree = tree;
+    }
+}
+
+
+export {$962758aa2f16f1a4$export$4445864b14128396 as TreeTester};
+//# sourceMappingURL=tree.module.js.map