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

package/README.md

@@ -1,3 +1,73 @@
 # @react-aria/test-utils
 
 This package is part of [react-spectrum](https://github.com/adobe/react-spectrum). See the repo for more details.
+
+See the [React Aria testing docs](https://react-aria.adobe.com/testing#react-aria-test-utils) for usage.
+
+`@react-aria/test-utils` is a set of testing utilities that aims to make writing unit tests easier for consumers of React Aria or for users who have built their own components following the respective ARIA pattern specification.
+
+> **Requirements:** This library uses [@testing-library/dom@10](https://www.npmjs.com/package/@testing-library/dom) and [@testing-library/user-event@14](https://www.npmjs.com/package/@testing-library/user-event). You need to be on React 18+ for these utilities to work.
+
+## Installation
+
+```
+npm install @react-aria/test-utils --dev
+```
+
+## Setup
+
+Initialize a `User` object at the top of your test file, and use it to create an ARIA pattern tester in your test cases. The tester has methods that you can call within your test to query for specific subcomponents or simulate common interactions.
+
+```ts
+// YourTest.test.ts
+import {screen} from '@testing-library/react';
+import {User} from '@react-aria/test-utils';
+
+// Provide whatever method of advancing timers you use in your test, this example assumes Jest with fake timers.
+// 'interactionType' specifies what mode of interaction should be simulated by the tester
+// 'advanceTimer' is used by the tester to advance the timers in the tests for specific interactions (e.g. long press)
+let testUtilUser = new User({interactionType: 'mouse', advanceTimer: jest.advanceTimersByTime});
+// ...
+
+it('my test case', async function () {
+  // Render your test component/app
+  render();
+  // Initialize the table tester via providing the 'Table' pattern name and the root element of said table
+  let table = testUtilUser.createTester('Table', {root: screen.getByTestId('test_table')});
+
+  // ...
+});
+```
+
+## User API
+
+```ts
+class User {
+  constructor(opts?: {
+    interactionType?: 'mouse' | 'keyboard' | 'touch',
+    advanceTimer?: (time?: number) => void | Promise<unknown>
+  });
+
+  createTester(patternName, opts): PatternTester;
+}
+```
+
+- `interactionType` — default modality used by testers created from this `User`. Individual testers can override this via `setInteractionType` or per-method options.
+- `advanceTimer` — used by testers to advance timers for interactions like long press. Pass `jest.advanceTimersByTime` (or your test framework's equivalent) when using fake timers.
+- `createTester(patternName, opts)` — returns a tester for the given ARIA pattern. `opts.root` is the root element of the component under test.
+
+## Patterns
+
+Below is a list of the ARIA patterns supported by `createTester`. See the accompanying component testing docs pages on the [React Aria docs site](https://react-aria.adobe.com/testing#react-aria-test-utils) for sample usage of each tester in a test suite.
+
+- [CheckboxGroup](https://react-aria.adobe.com/CheckboxGroup/testing)
+- [ComboBox](https://react-aria.adobe.com/ComboBox/testing)
+- Dialog via [Modal](https://react-aria.adobe.com/Modal/testing) / [Popover](https://react-aria.adobe.com/Popover/testing)
+- [GridList](https://react-aria.adobe.com/GridList/testing)
+- [ListBox](https://react-aria.adobe.com/ListBox/testing)
+- [Menu](https://react-aria.adobe.com/Menu/testing)
+- [RadioGroup](https://react-aria.adobe.com/RadioGroup/testing)
+- [Select](https://react-aria.adobe.com/Select/testing)
+- [Table](https://react-aria.adobe.com/Table/testing)
+- [Tabs](https://react-aria.adobe.com/Tabs/testing)
+- [Tree](https://react-aria.adobe.com/Tree/testing)

package/dist/import.mjs

@@ -1,6 +1,7 @@
-import {DEFAULT_LONG_PRESS_TIME as $5d1eca18f92ad0e6$export$4bd1d2d5ba6f5eaf, triggerLongPress as $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b} from "./events.mjs";
-import {installMouseEvent as $68df97871cfb5e33$export$de31e3987c917741, installPointerEvent as $68df97871cfb5e33$export$82f0b04c1d69a901} from "./testSetup.mjs";
-import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEventMaps.mjs";
+import {triggerLongPress as $b4e037a2907521c6$export$3a22a5a9bc0fd3b} from "./private/utils.js";
+import {installMouseEvent as $448e93e3748c7958$export$de31e3987c917741, installPointerEvent as $448e93e3748c7958$export$82f0b04c1d69a901} from "./private/testSetup.js";
+import {pointerMap as $759f061d800cf446$export$7dbde2c4caaa8d35} from "./private/userEventMaps.js";
+import {User as $4ab48216ddc89c32$export$1f44aaf2ec115b54} from "./private/user.js";
 
 /*
  * Copyright 2023 Adobe. All rights reserved.
@@ -17,5 +18,6 @@ import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEve
 
 
 
-export {$5d1eca18f92ad0e6$export$4bd1d2d5ba6f5eaf as DEFAULT_LONG_PRESS_TIME, $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b as triggerLongPress, $68df97871cfb5e33$export$de31e3987c917741 as installMouseEvent, $68df97871cfb5e33$export$82f0b04c1d69a901 as installPointerEvent, $50ecfb18069ec897$export$7dbde2c4caaa8d35 as pointerMap};
+
+export {$b4e037a2907521c6$export$3a22a5a9bc0fd3b as triggerLongPress, $448e93e3748c7958$export$de31e3987c917741 as installMouseEvent, $448e93e3748c7958$export$82f0b04c1d69a901 as installPointerEvent, $759f061d800cf446$export$7dbde2c4caaa8d35 as pointerMap, $4ab48216ddc89c32$export$1f44aaf2ec115b54 as User};
 //# sourceMappingURL=module.js.map

package/dist/main.js

@@ -1,24 +1,18 @@
-var $5a8bfe1663b8366d$exports = require("./events.main.js");
-var $b53408e40e8d56d0$exports = require("./testSetup.main.js");
-var $0e568517a25183a7$exports = require("./userEventMaps.main.js");
-
-
-function $parcel$exportWildcard(dest, source) {
-  Object.keys(source).forEach(function(key) {
-    if (key === 'default' || key === '__esModule' || Object.prototype.hasOwnProperty.call(dest, key)) {
-      return;
-    }
-
-    Object.defineProperty(dest, key, {
-      enumerable: true,
-      get: function get() {
-        return source[key];
-      }
-    });
-  });
-
-  return dest;
+var $022fcf8e360befed$exports = require("./private/utils.cjs");
+var $5e3c75beb0dad42b$exports = require("./private/testSetup.cjs");
+var $b3fc8c302673b35d$exports = require("./private/userEventMaps.cjs");
+var $3117e6a7fac3686b$exports = require("./private/user.cjs");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
 }
+
+$parcel$export(module.exports, "triggerLongPress", function () { return $022fcf8e360befed$exports.triggerLongPress; });
+$parcel$export(module.exports, "installMouseEvent", function () { return $5e3c75beb0dad42b$exports.installMouseEvent; });
+$parcel$export(module.exports, "installPointerEvent", function () { return $5e3c75beb0dad42b$exports.installPointerEvent; });
+$parcel$export(module.exports, "pointerMap", function () { return $b3fc8c302673b35d$exports.pointerMap; });
+$parcel$export(module.exports, "User", function () { return $3117e6a7fac3686b$exports.User; });
 /*
  * Copyright 2023 Adobe. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
@@ -32,9 +26,7 @@ function $parcel$exportWildcard(dest, source) {
  */ 
 
 
-$parcel$exportWildcard(module.exports, $5a8bfe1663b8366d$exports);
-$parcel$exportWildcard(module.exports, $b53408e40e8d56d0$exports);
-$parcel$exportWildcard(module.exports, $0e568517a25183a7$exports);
+
 
 
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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\nexport * from './events';\nexport * from './testSetup';\nexport * from './userEventMaps';\n"],"names":[],"version":3,"file":"main.js.map"}
+{"mappings":";;;;;;;;;;;;;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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\nexport {triggerLongPress} from './utils';\nexport {installMouseEvent, installPointerEvent} from './testSetup';\nexport {pointerMap} from './userEventMaps';\nexport {User} from './user';\nexport type {CheckboxGroupTester} from './checkboxgroup';\nexport type {ComboBoxTester} from './combobox';\nexport type {DialogTester} from './dialog';\nexport type {GridListTester} from './gridlist';\nexport type {ListBoxTester} from './listbox';\nexport type {MenuTester} from './menu';\nexport type {RadioGroupTester} from './radiogroup';\nexport type {SelectTester} from './select';\nexport type {TableTester} from './table';\nexport type {TabsTester} from './tabs';\nexport type {TreeTester} from './tree';\n\nexport type {UserOpts} from './types';\n"],"names":[],"version":3,"file":"main.js.map"}

package/dist/module.js

@@ -1,6 +1,7 @@
-import {DEFAULT_LONG_PRESS_TIME as $5d1eca18f92ad0e6$export$4bd1d2d5ba6f5eaf, triggerLongPress as $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b} from "./events.module.js";
-import {installMouseEvent as $68df97871cfb5e33$export$de31e3987c917741, installPointerEvent as $68df97871cfb5e33$export$82f0b04c1d69a901} from "./testSetup.module.js";
-import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEventMaps.module.js";
+import {triggerLongPress as $b4e037a2907521c6$export$3a22a5a9bc0fd3b} from "./private/utils.js";
+import {installMouseEvent as $448e93e3748c7958$export$de31e3987c917741, installPointerEvent as $448e93e3748c7958$export$82f0b04c1d69a901} from "./private/testSetup.js";
+import {pointerMap as $759f061d800cf446$export$7dbde2c4caaa8d35} from "./private/userEventMaps.js";
+import {User as $4ab48216ddc89c32$export$1f44aaf2ec115b54} from "./private/user.js";
 
 /*
  * Copyright 2023 Adobe. All rights reserved.
@@ -17,5 +18,6 @@ import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEve
 
 
 
-export {$5d1eca18f92ad0e6$export$4bd1d2d5ba6f5eaf as DEFAULT_LONG_PRESS_TIME, $5d1eca18f92ad0e6$export$3a22a5a9bc0fd3b as triggerLongPress, $68df97871cfb5e33$export$de31e3987c917741 as installMouseEvent, $68df97871cfb5e33$export$82f0b04c1d69a901 as installPointerEvent, $50ecfb18069ec897$export$7dbde2c4caaa8d35 as pointerMap};
+
+export {$b4e037a2907521c6$export$3a22a5a9bc0fd3b as triggerLongPress, $448e93e3748c7958$export$de31e3987c917741 as installMouseEvent, $448e93e3748c7958$export$82f0b04c1d69a901 as installPointerEvent, $759f061d800cf446$export$7dbde2c4caaa8d35 as pointerMap, $4ab48216ddc89c32$export$1f44aaf2ec115b54 as User};
 //# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -1 +1 @@
-{"mappings":";;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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\nexport * from './events';\nexport * from './testSetup';\nexport * from './userEventMaps';\n"],"names":[],"version":3,"file":"module.js.map"}
+{"mappings":";;;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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\nexport {triggerLongPress} from './utils';\nexport {installMouseEvent, installPointerEvent} from './testSetup';\nexport {pointerMap} from './userEventMaps';\nexport {User} from './user';\nexport type {CheckboxGroupTester} from './checkboxgroup';\nexport type {ComboBoxTester} from './combobox';\nexport type {DialogTester} from './dialog';\nexport type {GridListTester} from './gridlist';\nexport type {ListBoxTester} from './listbox';\nexport type {MenuTester} from './menu';\nexport type {RadioGroupTester} from './radiogroup';\nexport type {SelectTester} from './select';\nexport type {TableTester} from './table';\nexport type {TabsTester} from './tabs';\nexport type {TreeTester} from './tree';\n\nexport type {UserOpts} from './types';\n"],"names":[],"version":3,"file":"module.js.map"}

package/dist/private/act.cjs

@@ -0,0 +1,33 @@
+var $5POqM$react = require("react");
+var $5POqM$reactdomtestutils = require("react-dom/test-utils");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "act", function () { return $a84d573878cc1e5e$export$3ba232387fd5d6dd; });
+/*
+ * Copyright 2026 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.
+ */ 
+
+let $a84d573878cc1e5e$var$actImpl;
+if (typeof $5POqM$react.act === 'function') $a84d573878cc1e5e$var$actImpl = $5POqM$react.act;
+else $a84d573878cc1e5e$var$actImpl = $5POqM$reactdomtestutils.act;
+const $a84d573878cc1e5e$export$3ba232387fd5d6dd = (fn)=>{
+    // only wrap in act if in test environment, breaks vite browser test if test utils are used otherwise
+    if (// @ts-ignore
+    typeof IS_REACT_ACT_ENVIRONMENT === 'boolean' ? IS_REACT_ACT_ENVIRONMENT : typeof jest !== 'undefined') return $a84d573878cc1e5e$var$actImpl(fn);
+    return fn();
+};
+
+
+//# sourceMappingURL=act.cjs.map

package/dist/private/act.cjs.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;AAAA;;;;;;;;;;CAUC;;AAKD,IAAI;AACJ,IAAI,OAAO,qBAAc,YACvB,gCAAU;KAEV,gCAAU;AAGL,MAAM,4CAAsB,CAAA;IACjC,qGAAqG;IACrG,IACE,aAAa;IACb,OAAO,6BAA6B,YAEhC,2BACA,OAAO,SAAS,aAEpB,OAAO,8BAAQ;IAEjB,OAAO;AACT","sources":["packages/@react-aria/test-utils/src/act.ts"],"sourcesContent":["/*\n * Copyright 2026 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 * as React from 'react';\nimport * as ReactDOMTestUtils from 'react-dom/test-utils';\n\nlet actImpl: typeof ReactDOMTestUtils.act;\nif (typeof React.act === 'function') {\n  actImpl = React.act;\n} else {\n  actImpl = ReactDOMTestUtils.act;\n}\n\nexport const act: typeof actImpl = fn => {\n  // only wrap in act if in test environment, breaks vite browser test if test utils are used otherwise\n  if (\n    // @ts-ignore\n    typeof IS_REACT_ACT_ENVIRONMENT === 'boolean'\n      ? // @ts-ignore\n        IS_REACT_ACT_ENVIRONMENT\n      : typeof jest !== 'undefined'\n  ) {\n    return actImpl(fn);\n  }\n  return fn();\n};\n"],"names":[],"version":3,"file":"act.cjs.map"}

package/dist/private/act.js

@@ -0,0 +1,28 @@
+import {act as $1k33P$act} from "react";
+import {act as $1k33P$act1} from "react-dom/test-utils";
+
+/*
+ * Copyright 2026 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.
+ */ 
+
+let $1350703ef3ac1acc$var$actImpl;
+if (typeof $1k33P$act === 'function') $1350703ef3ac1acc$var$actImpl = $1k33P$act;
+else $1350703ef3ac1acc$var$actImpl = $1k33P$act1;
+const $1350703ef3ac1acc$export$3ba232387fd5d6dd = (fn)=>{
+    // only wrap in act if in test environment, breaks vite browser test if test utils are used otherwise
+    if (// @ts-ignore
+    typeof IS_REACT_ACT_ENVIRONMENT === 'boolean' ? IS_REACT_ACT_ENVIRONMENT : typeof jest !== 'undefined') return $1350703ef3ac1acc$var$actImpl(fn);
+    return fn();
+};
+
+
+export {$1350703ef3ac1acc$export$3ba232387fd5d6dd as act};
+//# sourceMappingURL=act.js.map

package/dist/private/act.js.map

@@ -0,0 +1 @@
+{"mappings":";;;AAAA;;;;;;;;;;CAUC;;AAKD,IAAI;AACJ,IAAI,OAAO,eAAc,YACvB,gCAAU;KAEV,gCAAU;AAGL,MAAM,4CAAsB,CAAA;IACjC,qGAAqG;IACrG,IACE,aAAa;IACb,OAAO,6BAA6B,YAEhC,2BACA,OAAO,SAAS,aAEpB,OAAO,8BAAQ;IAEjB,OAAO;AACT","sources":["packages/@react-aria/test-utils/src/act.ts"],"sourcesContent":["/*\n * Copyright 2026 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 * as React from 'react';\nimport * as ReactDOMTestUtils from 'react-dom/test-utils';\n\nlet actImpl: typeof ReactDOMTestUtils.act;\nif (typeof React.act === 'function') {\n  actImpl = React.act;\n} else {\n  actImpl = ReactDOMTestUtils.act;\n}\n\nexport const act: typeof actImpl = fn => {\n  // only wrap in act if in test environment, breaks vite browser test if test utils are used otherwise\n  if (\n    // @ts-ignore\n    typeof IS_REACT_ACT_ENVIRONMENT === 'boolean'\n      ? // @ts-ignore\n        IS_REACT_ACT_ENVIRONMENT\n      : typeof jest !== 'undefined'\n  ) {\n    return actImpl(fn);\n  }\n  return fn();\n};\n"],"names":[],"version":3,"file":"act.js.map"}

package/dist/private/checkboxgroup.cjs

@@ -0,0 +1,107 @@
+var $a84d573878cc1e5e$exports = require("./act.cjs");
+var $022fcf8e360befed$exports = require("./utils.cjs");
+var $aZ766$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, "CheckboxGroupTester", function () { return $2c71bb2c1e5033f0$export$f54f4bde770cc5a6; });
+/*
+ * 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 $2c71bb2c1e5033f0$export$f54f4bde770cc5a6 {
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._checkboxgroup = root;
+        let checkboxgroup = (0, $aZ766$testinglibrarydom.within)(root).queryAllByRole('group');
+        if (checkboxgroup.length > 0) this._checkboxgroup = checkboxgroup[0];
+    }
+    /**
+   * Set the interaction type used by the checkbox group tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Returns a checkbox matching the specified index or text content.
+   */ findCheckbox(opts) {
+        let { indexOrText: indexOrText } = opts;
+        let checkbox;
+        if (typeof indexOrText === 'number') checkbox = this.getCheckboxes()[indexOrText];
+        else if (typeof indexOrText === 'string') {
+            let label = (0, $aZ766$testinglibrarydom.within)(this.getCheckboxGroup()).getByText(indexOrText);
+            // Label may wrap the checkbox, or the actual label may be a sibling span, or the checkbox div could have the label within it
+            if (label) {
+                checkbox = (0, $aZ766$testinglibrarydom.within)(label).queryByRole('checkbox');
+                if (!checkbox) {
+                    let labelWrapper = label.closest('label');
+                    if (labelWrapper) checkbox = (0, $aZ766$testinglibrarydom.within)(labelWrapper).queryByRole('checkbox');
+                    else checkbox = label.closest('[role=checkbox]');
+                }
+            }
+        }
+        return checkbox;
+    }
+    async keyboardNavigateToCheckbox(opts) {
+        let { checkbox: checkbox } = opts;
+        let checkboxes = this.getCheckboxes();
+        checkboxes = checkboxes.filter((checkbox)=>!(checkbox.hasAttribute('disabled') || checkbox.getAttribute('aria-disabled') === 'true'));
+        if (checkboxes.length === 0) throw new Error('Checkbox group doesnt have any non-disabled checkboxes. Please double check your checkbox group.');
+        let targetIndex = checkboxes.indexOf(checkbox);
+        if (targetIndex === -1) throw new Error('Checkbox provided is not in the checkbox group.');
+        if (!this.getCheckboxGroup().contains(document.activeElement)) (0, $a84d573878cc1e5e$exports.act)(()=>checkboxes[0].focus());
+        let currIndex = checkboxes.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('Active element is not in the checkbox group.');
+        for(let i = 0; i < Math.abs(targetIndex - currIndex); i++)await this.user.tab({
+            shift: targetIndex < currIndex
+        });
+    }
+    /**
+   * Toggles the specified checkbox. Defaults to using the interaction type set on the checkbox
+   * tester.
+   */ async toggleCheckbox(opts) {
+        let { checkbox: checkbox, interactionType: interactionType = this._interactionType } = opts;
+        if (typeof checkbox === 'string' || typeof checkbox === 'number') checkbox = this.findCheckbox({
+            indexOrText: checkbox
+        });
+        if (!checkbox) throw new Error(`Target checkbox "${(0, $022fcf8e360befed$exports.formatTargetNode)(opts.checkbox)}" not found in the checkboxgroup.`);
+        else if (checkbox.hasAttribute('disabled')) throw new Error(`Target checkbox "${(0, $022fcf8e360befed$exports.formatTargetNode)(opts.checkbox)}" is disabled.`);
+        if (interactionType === 'keyboard') {
+            await this.keyboardNavigateToCheckbox({
+                checkbox: checkbox
+            });
+            await this.user.keyboard('[Space]');
+        } else await (0, $022fcf8e360befed$exports.pressElement)(this.user, checkbox, interactionType);
+    }
+    /**
+   * Returns the checkboxgroup.
+   */ getCheckboxGroup() {
+        return this._checkboxgroup;
+    }
+    /**
+   * Returns the checkboxes.
+   */ getCheckboxes() {
+        return (0, $aZ766$testinglibrarydom.within)(this.getCheckboxGroup()).queryAllByRole('checkbox');
+    }
+    /**
+   * Returns the currently selected checkboxes in the checkboxgroup if any.
+   */ getSelectedCheckboxes() {
+        return this.getCheckboxes().filter((checkbox)=>checkbox.checked || checkbox.getAttribute('aria-checked') === 'true');
+    }
+}
+
+
+//# sourceMappingURL=checkboxgroup.cjs.map

package/dist/private/checkboxgroup.cjs.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/@react-aria/test-utils/src/checkboxgroup.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 {CheckboxGroupTesterOpts, UserOpts} from './types';\nimport {formatTargetNode, pressElement} from './utils';\nimport {within} from '@testing-library/dom';\n\ninterface TriggerCheckboxOptions {\n  /**\n   * What interaction type to use when triggering a checkbox. Defaults to the interaction type set\n   * on the tester.\n   */\n  interactionType?: UserOpts['interactionType'];\n  /**\n   * The index, text, or node of the checkbox to toggle selection for.\n   */\n  checkbox: number | string | HTMLElement;\n}\n\nexport class CheckboxGroupTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _checkboxgroup: HTMLElement;\n\n  constructor(opts: CheckboxGroupTesterOpts) {\n    let {root, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n\n    this._checkboxgroup = root;\n    let checkboxgroup = within(root).queryAllByRole('group');\n    if (checkboxgroup.length > 0) {\n      this._checkboxgroup = checkboxgroup[0];\n    }\n  }\n\n  /**\n   * Set the interaction type used by the checkbox group tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Returns a checkbox matching the specified index or text content.\n   */\n  findCheckbox(opts: {indexOrText: number | string}): HTMLElement {\n    let {indexOrText} = opts;\n\n    let checkbox;\n    if (typeof indexOrText === 'number') {\n      checkbox = this.getCheckboxes()[indexOrText];\n    } else if (typeof indexOrText === 'string') {\n      let label = within(this.getCheckboxGroup()).getByText(indexOrText);\n\n      // Label may wrap the checkbox, or the actual label may be a sibling span, or the checkbox div could have the label within it\n      if (label) {\n        checkbox = within(label).queryByRole('checkbox');\n        if (!checkbox) {\n          let labelWrapper = label.closest('label');\n          if (labelWrapper) {\n            checkbox = within(labelWrapper).queryByRole('checkbox');\n          } else {\n            checkbox = label.closest('[role=checkbox]');\n          }\n        }\n      }\n    }\n\n    return checkbox;\n  }\n\n  private async keyboardNavigateToCheckbox(opts: {checkbox: HTMLElement}) {\n    let {checkbox} = opts;\n    let checkboxes = this.getCheckboxes();\n    checkboxes = checkboxes.filter(\n      checkbox =>\n        !(checkbox.hasAttribute('disabled') || checkbox.getAttribute('aria-disabled') === 'true')\n    );\n    if (checkboxes.length === 0) {\n      throw new Error(\n        'Checkbox group doesnt have any non-disabled checkboxes. Please double check your checkbox group.'\n      );\n    }\n\n    let targetIndex = checkboxes.indexOf(checkbox);\n    if (targetIndex === -1) {\n      throw new Error('Checkbox provided is not in the checkbox group.');\n    }\n\n    if (!this.getCheckboxGroup().contains(document.activeElement)) {\n      act(() => checkboxes[0].focus());\n    }\n\n    let currIndex = checkboxes.indexOf(document.activeElement as HTMLElement);\n    if (currIndex === -1) {\n      throw new Error('Active element is not in the checkbox group.');\n    }\n\n    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {\n      await this.user.tab({shift: targetIndex < currIndex});\n    }\n  }\n\n  /**\n   * Toggles the specified checkbox. Defaults to using the interaction type set on the checkbox\n   * tester.\n   */\n  async toggleCheckbox(opts: TriggerCheckboxOptions): Promise<void> {\n    let {checkbox, interactionType = this._interactionType} = opts;\n\n    if (typeof checkbox === 'string' || typeof checkbox === 'number') {\n      checkbox = this.findCheckbox({indexOrText: checkbox});\n    }\n\n    if (!checkbox) {\n      throw new Error(\n        `Target checkbox \"${formatTargetNode(opts.checkbox)}\" not found in the checkboxgroup.`\n      );\n    } else if (checkbox.hasAttribute('disabled')) {\n      throw new Error(`Target checkbox \"${formatTargetNode(opts.checkbox)}\" is disabled.`);\n    }\n\n    if (interactionType === 'keyboard') {\n      await this.keyboardNavigateToCheckbox({checkbox});\n      await this.user.keyboard('[Space]');\n    } else {\n      await pressElement(this.user, checkbox, interactionType);\n    }\n  }\n\n  /**\n   * Returns the checkboxgroup.\n   */\n  getCheckboxGroup(): HTMLElement {\n    return this._checkboxgroup;\n  }\n\n  /**\n   * Returns the checkboxes.\n   */\n  getCheckboxes(): HTMLElement[] {\n    return within(this.getCheckboxGroup()).queryAllByRole('checkbox');\n  }\n\n  /**\n   * Returns the currently selected checkboxes in the checkboxgroup if any.\n   */\n  getSelectedCheckboxes(): HTMLElement[] {\n    return this.getCheckboxes().filter(\n      checkbox =>\n        (checkbox as HTMLInputElement).checked || checkbox.getAttribute('aria-checked') === 'true'\n    );\n  }\n}\n"],"names":[],"version":3,"file":"checkboxgroup.cjs.map"}

package/dist/private/checkboxgroup.js

@@ -0,0 +1,102 @@
+import {act as $1350703ef3ac1acc$export$3ba232387fd5d6dd} from "./act.js";
+import {formatTargetNode as $b4e037a2907521c6$export$bc3bc4a9206bf789, pressElement as $b4e037a2907521c6$export$6ffa3eb717517feb} from "./utils.js";
+import {within as $g4drr$within} from "@testing-library/dom";
+
+/*
+ * 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 $e7160b4be83b4967$export$f54f4bde770cc5a6 {
+    constructor(opts){
+        let { root: root, user: user, interactionType: interactionType } = opts;
+        this.user = user;
+        this._interactionType = interactionType || 'mouse';
+        this._checkboxgroup = root;
+        let checkboxgroup = (0, $g4drr$within)(root).queryAllByRole('group');
+        if (checkboxgroup.length > 0) this._checkboxgroup = checkboxgroup[0];
+    }
+    /**
+   * Set the interaction type used by the checkbox group tester.
+   */ setInteractionType(type) {
+        this._interactionType = type;
+    }
+    /**
+   * Returns a checkbox matching the specified index or text content.
+   */ findCheckbox(opts) {
+        let { indexOrText: indexOrText } = opts;
+        let checkbox;
+        if (typeof indexOrText === 'number') checkbox = this.getCheckboxes()[indexOrText];
+        else if (typeof indexOrText === 'string') {
+            let label = (0, $g4drr$within)(this.getCheckboxGroup()).getByText(indexOrText);
+            // Label may wrap the checkbox, or the actual label may be a sibling span, or the checkbox div could have the label within it
+            if (label) {
+                checkbox = (0, $g4drr$within)(label).queryByRole('checkbox');
+                if (!checkbox) {
+                    let labelWrapper = label.closest('label');
+                    if (labelWrapper) checkbox = (0, $g4drr$within)(labelWrapper).queryByRole('checkbox');
+                    else checkbox = label.closest('[role=checkbox]');
+                }
+            }
+        }
+        return checkbox;
+    }
+    async keyboardNavigateToCheckbox(opts) {
+        let { checkbox: checkbox } = opts;
+        let checkboxes = this.getCheckboxes();
+        checkboxes = checkboxes.filter((checkbox)=>!(checkbox.hasAttribute('disabled') || checkbox.getAttribute('aria-disabled') === 'true'));
+        if (checkboxes.length === 0) throw new Error('Checkbox group doesnt have any non-disabled checkboxes. Please double check your checkbox group.');
+        let targetIndex = checkboxes.indexOf(checkbox);
+        if (targetIndex === -1) throw new Error('Checkbox provided is not in the checkbox group.');
+        if (!this.getCheckboxGroup().contains(document.activeElement)) (0, $1350703ef3ac1acc$export$3ba232387fd5d6dd)(()=>checkboxes[0].focus());
+        let currIndex = checkboxes.indexOf(document.activeElement);
+        if (currIndex === -1) throw new Error('Active element is not in the checkbox group.');
+        for(let i = 0; i < Math.abs(targetIndex - currIndex); i++)await this.user.tab({
+            shift: targetIndex < currIndex
+        });
+    }
+    /**
+   * Toggles the specified checkbox. Defaults to using the interaction type set on the checkbox
+   * tester.
+   */ async toggleCheckbox(opts) {
+        let { checkbox: checkbox, interactionType: interactionType = this._interactionType } = opts;
+        if (typeof checkbox === 'string' || typeof checkbox === 'number') checkbox = this.findCheckbox({
+            indexOrText: checkbox
+        });
+        if (!checkbox) throw new Error(`Target checkbox "${(0, $b4e037a2907521c6$export$bc3bc4a9206bf789)(opts.checkbox)}" not found in the checkboxgroup.`);
+        else if (checkbox.hasAttribute('disabled')) throw new Error(`Target checkbox "${(0, $b4e037a2907521c6$export$bc3bc4a9206bf789)(opts.checkbox)}" is disabled.`);
+        if (interactionType === 'keyboard') {
+            await this.keyboardNavigateToCheckbox({
+                checkbox: checkbox
+            });
+            await this.user.keyboard('[Space]');
+        } else await (0, $b4e037a2907521c6$export$6ffa3eb717517feb)(this.user, checkbox, interactionType);
+    }
+    /**
+   * Returns the checkboxgroup.
+   */ getCheckboxGroup() {
+        return this._checkboxgroup;
+    }
+    /**
+   * Returns the checkboxes.
+   */ getCheckboxes() {
+        return (0, $g4drr$within)(this.getCheckboxGroup()).queryAllByRole('checkbox');
+    }
+    /**
+   * Returns the currently selected checkboxes in the checkboxgroup if any.
+   */ getSelectedCheckboxes() {
+        return this.getCheckboxes().filter((checkbox)=>checkbox.checked || checkbox.getAttribute('aria-checked') === 'true');
+    }
+}
+
+
+export {$e7160b4be83b4967$export$f54f4bde770cc5a6 as CheckboxGroupTester};
+//# sourceMappingURL=checkboxgroup.js.map

package/dist/private/checkboxgroup.js.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/@react-aria/test-utils/src/checkboxgroup.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 {CheckboxGroupTesterOpts, UserOpts} from './types';\nimport {formatTargetNode, pressElement} from './utils';\nimport {within} from '@testing-library/dom';\n\ninterface TriggerCheckboxOptions {\n  /**\n   * What interaction type to use when triggering a checkbox. Defaults to the interaction type set\n   * on the tester.\n   */\n  interactionType?: UserOpts['interactionType'];\n  /**\n   * The index, text, or node of the checkbox to toggle selection for.\n   */\n  checkbox: number | string | HTMLElement;\n}\n\nexport class CheckboxGroupTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _checkboxgroup: HTMLElement;\n\n  constructor(opts: CheckboxGroupTesterOpts) {\n    let {root, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n\n    this._checkboxgroup = root;\n    let checkboxgroup = within(root).queryAllByRole('group');\n    if (checkboxgroup.length > 0) {\n      this._checkboxgroup = checkboxgroup[0];\n    }\n  }\n\n  /**\n   * Set the interaction type used by the checkbox group tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Returns a checkbox matching the specified index or text content.\n   */\n  findCheckbox(opts: {indexOrText: number | string}): HTMLElement {\n    let {indexOrText} = opts;\n\n    let checkbox;\n    if (typeof indexOrText === 'number') {\n      checkbox = this.getCheckboxes()[indexOrText];\n    } else if (typeof indexOrText === 'string') {\n      let label = within(this.getCheckboxGroup()).getByText(indexOrText);\n\n      // Label may wrap the checkbox, or the actual label may be a sibling span, or the checkbox div could have the label within it\n      if (label) {\n        checkbox = within(label).queryByRole('checkbox');\n        if (!checkbox) {\n          let labelWrapper = label.closest('label');\n          if (labelWrapper) {\n            checkbox = within(labelWrapper).queryByRole('checkbox');\n          } else {\n            checkbox = label.closest('[role=checkbox]');\n          }\n        }\n      }\n    }\n\n    return checkbox;\n  }\n\n  private async keyboardNavigateToCheckbox(opts: {checkbox: HTMLElement}) {\n    let {checkbox} = opts;\n    let checkboxes = this.getCheckboxes();\n    checkboxes = checkboxes.filter(\n      checkbox =>\n        !(checkbox.hasAttribute('disabled') || checkbox.getAttribute('aria-disabled') === 'true')\n    );\n    if (checkboxes.length === 0) {\n      throw new Error(\n        'Checkbox group doesnt have any non-disabled checkboxes. Please double check your checkbox group.'\n      );\n    }\n\n    let targetIndex = checkboxes.indexOf(checkbox);\n    if (targetIndex === -1) {\n      throw new Error('Checkbox provided is not in the checkbox group.');\n    }\n\n    if (!this.getCheckboxGroup().contains(document.activeElement)) {\n      act(() => checkboxes[0].focus());\n    }\n\n    let currIndex = checkboxes.indexOf(document.activeElement as HTMLElement);\n    if (currIndex === -1) {\n      throw new Error('Active element is not in the checkbox group.');\n    }\n\n    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {\n      await this.user.tab({shift: targetIndex < currIndex});\n    }\n  }\n\n  /**\n   * Toggles the specified checkbox. Defaults to using the interaction type set on the checkbox\n   * tester.\n   */\n  async toggleCheckbox(opts: TriggerCheckboxOptions): Promise<void> {\n    let {checkbox, interactionType = this._interactionType} = opts;\n\n    if (typeof checkbox === 'string' || typeof checkbox === 'number') {\n      checkbox = this.findCheckbox({indexOrText: checkbox});\n    }\n\n    if (!checkbox) {\n      throw new Error(\n        `Target checkbox \"${formatTargetNode(opts.checkbox)}\" not found in the checkboxgroup.`\n      );\n    } else if (checkbox.hasAttribute('disabled')) {\n      throw new Error(`Target checkbox \"${formatTargetNode(opts.checkbox)}\" is disabled.`);\n    }\n\n    if (interactionType === 'keyboard') {\n      await this.keyboardNavigateToCheckbox({checkbox});\n      await this.user.keyboard('[Space]');\n    } else {\n      await pressElement(this.user, checkbox, interactionType);\n    }\n  }\n\n  /**\n   * Returns the checkboxgroup.\n   */\n  getCheckboxGroup(): HTMLElement {\n    return this._checkboxgroup;\n  }\n\n  /**\n   * Returns the checkboxes.\n   */\n  getCheckboxes(): HTMLElement[] {\n    return within(this.getCheckboxGroup()).queryAllByRole('checkbox');\n  }\n\n  /**\n   * Returns the currently selected checkboxes in the checkboxgroup if any.\n   */\n  getSelectedCheckboxes(): HTMLElement[] {\n    return this.getCheckboxes().filter(\n      checkbox =>\n        (checkbox as HTMLInputElement).checked || checkbox.getAttribute('aria-checked') === 'true'\n    );\n  }\n}\n"],"names":[],"version":3,"file":"checkboxgroup.js.map"}