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

package/dist/types.d.ts

@@ -1,11 +1,193 @@
 import { pointerKey } from "@testing-library/user-event/system/pointer/shared";
-export const DEFAULT_LONG_PRESS_TIME = 500;
+interface ComboBoxOptions extends UserOpts, BaseTesterOpts {
+    user?: any;
+    trigger?: HTMLElement;
+}
+declare class ComboBoxTester {
+    constructor(opts: ComboBoxOptions);
+    setInteractionType: (type: UserOpts["interactionType"]) => void;
+    open: (opts?: {
+        triggerBehavior?: "focus" | "manual";
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    selectOption: (opts?: {
+        option?: HTMLElement;
+        optionText?: string;
+        triggerBehavior?: "focus" | "manual";
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    close: () => Promise<void>;
+    get combobox(): HTMLElement;
+    get trigger(): HTMLElement | undefined;
+    get listbox(): HTMLElement | undefined;
+    options: (opts?: {
+        element?: HTMLElement;
+    }) => HTMLElement[] | never[];
+    get sections(): HTMLElement[];
+    get focusedOption(): HTMLElement | null | undefined;
+}
+interface GridListOptions extends UserOpts, BaseTesterOpts {
+    user?: any;
+}
+declare class GridListTester {
+    constructor(opts: GridListOptions);
+    setInteractionType: (type: UserOpts["interactionType"]) => void;
+    toggleRowSelection: (opts?: {
+        index?: number;
+        text?: string;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    findRow: (opts: {
+        index?: number;
+        text?: string;
+    }) => any;
+    triggerRowAction: (opts: {
+        index?: number;
+        text?: string;
+        needsDoubleClick?: boolean;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    get gridlist(): HTMLElement;
+    get rows(): HTMLElement[];
+    get selectedRows(): HTMLElement[];
+    cells: (opts?: {
+        element?: HTMLElement;
+    }) => HTMLElement[];
+}
+interface MenuOptions extends UserOpts, BaseTesterOpts {
+    user?: any;
+    isSubmenu?: boolean;
+}
+declare class MenuTester {
+    constructor(opts: MenuOptions);
+    setInteractionType: (type: UserOpts["interactionType"]) => void;
+    open: (opts?: {
+        needsLongPress?: boolean;
+        interactionType?: UserOpts["interactionType"];
+        direction?: "up" | "down";
+    }) => Promise<void>;
+    selectOption: (opts: {
+        option?: HTMLElement;
+        optionText?: string;
+        menuSelectionMode?: "single" | "multiple";
+        needsLongPress?: boolean;
+        closesOnSelect?: boolean;
+        interactionType?: UserOpts["interactionType"];
+        keyboardActivation?: "Space" | "Enter";
+    }) => Promise<void>;
+    openSubmenu: (opts: {
+        submenuTrigger?: HTMLElement;
+        submenuTriggerText?: string;
+        needsLongPress?: boolean;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<MenuTester | null>;
+    keyboardNavigateToOption: (opts: {
+        option: HTMLElement;
+    }) => Promise<void>;
+    close: () => Promise<void>;
+    get trigger(): HTMLElement;
+    get menu(): HTMLElement | null | undefined;
+    get options(): HTMLElement[];
+    get sections(): HTMLElement[];
+    get submenuTriggers(): HTMLElement[];
+}
+interface SelectOptions extends UserOpts, BaseTesterOpts {
+    user?: any;
+}
+declare class SelectTester {
+    constructor(opts: SelectOptions);
+    setInteractionType: (type: UserOpts["interactionType"]) => void;
+    open: (opts?: {
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    selectOption: (opts: {
+        optionText: string;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    close: () => Promise<void>;
+    get trigger(): HTMLElement;
+    get listbox(): HTMLElement | null | undefined;
+    get options(): HTMLElement[];
+    get sections(): HTMLElement[];
+}
+interface TableOptions extends UserOpts, BaseTesterOpts {
+    user?: any;
+    advanceTimer: UserOpts['advanceTimer'];
+}
+declare class TableTester {
+    constructor(opts: TableOptions);
+    setInteractionType: (type: UserOpts["interactionType"]) => void;
+    toggleRowSelection: (opts?: {
+        index?: number;
+        text?: string;
+        needsLongPress?: boolean;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    toggleSort: (opts?: {
+        index?: number;
+        text?: string;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    triggerRowAction: (opts?: {
+        index?: number;
+        text?: string;
+        needsDoubleClick?: boolean;
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    toggleSelectAll: (opts?: {
+        interactionType?: UserOpts["interactionType"];
+    }) => Promise<void>;
+    findRow: (opts?: {
+        index?: number;
+        text?: string;
+    }) => any;
+    findCell: (opts: {
+        text: string;
+    }) => HTMLElement;
+    get table(): HTMLElement;
+    get rowGroups(): HTMLElement[];
+    get columns(): HTMLElement[];
+    get rows(): HTMLElement[];
+    get selectedRows(): HTMLElement[];
+    get rowHeaders(): HTMLElement[];
+    get cells(): HTMLElement[];
+}
+export interface UserOpts {
+    interactionType?: 'mouse' | 'touch' | 'keyboard';
+    advanceTimer?: (time?: number) => void | Promise<unknown>;
+}
+interface BaseTesterOpts {
+    root: HTMLElement;
+}
+declare let keyToUtil: {
+    readonly Select: typeof SelectTester;
+    readonly Table: typeof TableTester;
+    readonly Menu: typeof MenuTester;
+    readonly ComboBox: typeof ComboBoxTester;
+    readonly GridList: typeof GridListTester;
+};
+type PatternNames = keyof typeof keyToUtil;
+type ObjectType<T> = T extends 'Select' ? SelectTester : T extends 'Table' ? TableTester : T extends 'Menu' ? MenuTester : T extends 'ComboBox' ? ComboBoxTester : T extends 'GridList' ? GridListTester : never;
+type ObjectOptionsTypes<T> = T extends 'Select' ? SelectOptions : T extends 'Table' ? TableOptions : T extends 'Menu' ? MenuOptions : T extends 'ComboBox' ? ComboBoxOptions : T extends 'GridList' ? GridListOptions : never;
+export class User {
+    user: any;
+    interactionType: UserOpts['interactionType'];
+    advanceTimer: UserOpts['advanceTimer'];
+    constructor(opts?: UserOpts);
+    createTester<T extends PatternNames>(patternName: T, opts: ObjectOptionsTypes<T>): ObjectType<T>;
+}
 /**
  * Simulates a "long press" event on a element.
- * @param element - Element to long press.
- * @param opts - Options to pass to the simulated event. See https://testing-library.com/docs/dom-testing-library/api-events/#fireevent for more info.
+ * @param opts - Options for the long press.
+ * @param opts.element - Element to long press.
+ * @param opts.advanceTimer - Function that when called advances the timers in your test suite by a specific amount of time(ms).
+ * @param opts.pointeropts - Options to pass to the simulated event. Defaults to mouse. See https://testing-library.com/docs/dom-testing-library/api-events/#fireevent for more info.
  */
-export function triggerLongPress(element: HTMLElement, opts?: {}): void;
+export function triggerLongPress(opts: {
+    element: HTMLElement;
+    advanceTimer: (time?: number) => void | Promise<unknown>;
+    pointerOpts?: {};
+}): Promise<void>;
 /**
  * Enables reading pageX/pageY from fireEvent.mouse*(..., {pageX: ..., pageY: ...}).
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"mappings":";AAcA,OAAO,MAAM,6BAA6B,CAAC;AAE3C;;;;GAIG;AACH,iCAAiC,OAAO,EAAE,WAAW,EAAE,IAAI,KAAK,GAAG,IAAI,CAMtE;ACfD;;GAEG;AACH,0CAwBC;AAED,4CAiCC;ACxED,OAAO,IAAI,YAAY,UAAU,EAOL,CAAC","sources":["packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/events.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/testSetup.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/userEventMaps.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/index.ts","packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":[null,null,null,null,"/*\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":"types.d.ts.map"}
+{"mappings":"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","sources":["packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/combobox.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/gridlist.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/menu.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/select.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/table.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/user.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/events.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/testSetup.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/userEventMaps.ts","packages/@react-aria/test-utils/src/packages/@react-aria/test-utils/src/index.ts","packages/@react-aria/test-utils/src/index.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,"/*\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 './events';\nexport {installMouseEvent, installPointerEvent} from './testSetup';\nexport {pointerMap} from './userEventMaps';\nexport {User} from './user';\n\nexport type {UserOpts} from './user';\n"],"names":[],"version":3,"file":"types.d.ts.map"}

package/dist/user.main.js

@@ -0,0 +1,65 @@
+var $15e4b71f2b6c4964$exports = require("./combobox.main.js");
+var $30ee8e379774bea4$exports = require("./gridlist.main.js");
+var $31965f39292c8e99$exports = require("./menu.main.js");
+var $0e568517a25183a7$exports = require("./userEventMaps.main.js");
+var $b97d5a42df7c75b2$exports = require("./select.main.js");
+var $80a9def682ac1297$exports = require("./table.main.js");
+var $iYqJR$testinglibraryuserevent = require("@testing-library/user-event");
+
+
+function $parcel$interopDefault(a) {
+  return a && a.__esModule ? a.default : a;
+}
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "User", () => $4168d511756883ff$export$1f44aaf2ec115b54);
+/*
+ * 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.
+ */ 
+
+
+
+
+
+
+let $4168d511756883ff$var$keyToUtil = {
+    'Select': (0, $b97d5a42df7c75b2$exports.SelectTester),
+    'Table': (0, $80a9def682ac1297$exports.TableTester),
+    'Menu': (0, $31965f39292c8e99$exports.MenuTester),
+    'ComboBox': (0, $15e4b71f2b6c4964$exports.ComboBoxTester),
+    'GridList': (0, $30ee8e379774bea4$exports.GridListTester)
+};
+let $4168d511756883ff$var$defaultAdvanceTimer = async (waitTime)=>await new Promise((resolve)=>setTimeout(resolve, waitTime));
+class $4168d511756883ff$export$1f44aaf2ec115b54 {
+    createTester(patternName, opts) {
+        return new $4168d511756883ff$var$keyToUtil[patternName]({
+            user: this.user,
+            interactionType: this.interactionType,
+            advanceTimer: this.advanceTimer,
+            ...opts
+        });
+    }
+    constructor(opts = {}){
+        let { interactionType: interactionType, advanceTimer: advanceTimer } = opts;
+        this.user = (0, ($parcel$interopDefault($iYqJR$testinglibraryuserevent))).setup({
+            delay: null,
+            pointerMap: $0e568517a25183a7$exports.pointerMap
+        });
+        this.interactionType = interactionType;
+        this.advanceTimer = advanceTimer || $4168d511756883ff$var$defaultAdvanceTimer;
+    }
+}
+
+
+//# sourceMappingURL=user.main.js.map

package/dist/user.main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;CAUC;;;;;;;AAyBD,IAAI,kCAAY;IAAC,UAAU,CAAA,GAAA,sCAAW;IAAG,SAAS,CAAA,GAAA,qCAAU;IAAG,QAAQ,CAAA,GAAA,oCAAS;IAAG,YAAY,CAAA,GAAA,wCAAa;IAAG,YAAY,CAAA,GAAA,wCAAa;AAAC;AAoBzI,IAAI,4CAAsB,OAAO,WAAiC,MAAM,IAAI,QAAQ,CAAC,UAAY,WAAW,SAAS;AAE9G,MAAM;IAYX,aAAqC,WAAc,EAAE,IAA2B,EAAiB;QAC/F,OAAO,IAAI,AAAC,+BAAU,CAAC,YAAY,CAAC;YAAC,MAAM,IAAI,CAAC,IAAI;YAAE,iBAAiB,IAAI,CAAC,eAAe;YAAE,cAAc,IAAI,CAAC,YAAY;YAAE,GAAG,IAAI;QAAA;IACvI;IATA,YAAY,OAAiB,CAAC,CAAC,CAAE;QAC/B,IAAI,mBAAC,eAAe,gBAAE,YAAY,EAAC,GAAG;QACtC,IAAI,CAAC,IAAI,GAAG,CAAA,GAAA,wDAAQ,EAAE,KAAK,CAAC;YAAC,OAAO;wBAAM;QAAU;QACpD,IAAI,CAAC,eAAe,GAAG;QACvB,IAAI,CAAC,YAAY,GAAG,gBAAgB;IACtC;AAKF","sources":["packages/@react-aria/test-utils/src/user.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 {ComboBoxOptions, ComboBoxTester} from './combobox';\nimport {GridListOptions, GridListTester} from './gridlist';\nimport {MenuOptions, MenuTester} from './menu';\nimport {pointerMap} from './';\nimport {SelectOptions, SelectTester} from './select';\nimport {TableOptions, TableTester} from './table';\nimport userEvent from '@testing-library/user-event';\n\n// https://github.com/testing-library/dom-testing-library/issues/939#issuecomment-830771708 is an interesting way of allowing users to configure the timers\n// curent way is like https://testing-library.com/docs/user-event/options/#advancetimers,\nexport interface UserOpts {\n  interactionType?: 'mouse' | 'touch' | 'keyboard',\n  // If using fake timers user should provide something like (time) => jest.advanceTimersByTime(time))}\n  // A real timer user would pass async () => await new Promise((resolve) => setTimeout(resolve, waitTime))\n  // Time is in ms.\n  advanceTimer?: (time?: number) => void | Promise<unknown>\n}\n\nexport interface BaseTesterOpts {\n  // The base element for the given tester (e.g. the table, menu trigger, etc)\n  root: HTMLElement\n}\n\nlet keyToUtil = {'Select': SelectTester, 'Table': TableTester, 'Menu': MenuTester, 'ComboBox': ComboBoxTester, 'GridList': GridListTester} as const;\nexport type PatternNames = keyof typeof keyToUtil;\n\n// Conditional type: https://www.typescriptlang.org/docs/handbook/2/conditional-types.html\ntype ObjectType<T> =\n    T extends 'Select' ? SelectTester :\n    T extends 'Table' ? TableTester :\n    T extends 'Menu' ? MenuTester :\n    T extends 'ComboBox' ? ComboBoxTester :\n    T extends 'GridList' ? GridListTester :\n    never;\n\ntype ObjectOptionsTypes<T> =\n  T extends 'Select' ? SelectOptions :\n  T extends 'Table' ? TableOptions :\n  T extends 'Menu' ? MenuOptions :\n  T extends 'ComboBox' ? ComboBoxOptions :\n  T extends 'GridList' ? GridListOptions :\n  never;\n\nlet defaultAdvanceTimer = async (waitTime: number | undefined) => await new Promise((resolve) => setTimeout(resolve, waitTime));\n\nexport class User {\n  user;\n  interactionType: UserOpts['interactionType'];\n  advanceTimer: UserOpts['advanceTimer'];\n\n  constructor(opts: UserOpts = {}) {\n    let {interactionType, advanceTimer} = opts;\n    this.user = userEvent.setup({delay: null, pointerMap});\n    this.interactionType = interactionType;\n    this.advanceTimer = advanceTimer || defaultAdvanceTimer;\n  }\n\n  createTester<T extends PatternNames>(patternName: T, opts: ObjectOptionsTypes<T>): ObjectType<T> {\n    return new (keyToUtil)[patternName]({user: this.user, interactionType: this.interactionType, advanceTimer: this.advanceTimer, ...opts}) as ObjectType<T>;\n  }\n}\n"],"names":[],"version":3,"file":"user.main.js.map"}

package/dist/user.mjs

@@ -0,0 +1,56 @@
+import {ComboBoxTester as $dab75f394483aa9c$export$f97e14e96d71ab3b} from "./combobox.mjs";
+import {GridListTester as $5ca9e9228f508f75$export$93a85aaed9fabd83} from "./gridlist.mjs";
+import {MenuTester as $74b93f0617179929$export$f73bbc9212ed861e} from "./menu.mjs";
+import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEventMaps.mjs";
+import {SelectTester as $4350df3e19e40e36$export$d1859707465446a9} from "./select.mjs";
+import {TableTester as $6d1e4cf220920c37$export$4c6a9d6ae3b0086} from "./table.mjs";
+import $gmkhN$testinglibraryuserevent from "@testing-library/user-event";
+
+/*
+ * 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.
+ */ 
+
+
+
+
+
+
+let $0d71b4e9cc4df40a$var$keyToUtil = {
+    'Select': (0, $4350df3e19e40e36$export$d1859707465446a9),
+    'Table': (0, $6d1e4cf220920c37$export$4c6a9d6ae3b0086),
+    'Menu': (0, $74b93f0617179929$export$f73bbc9212ed861e),
+    'ComboBox': (0, $dab75f394483aa9c$export$f97e14e96d71ab3b),
+    'GridList': (0, $5ca9e9228f508f75$export$93a85aaed9fabd83)
+};
+let $0d71b4e9cc4df40a$var$defaultAdvanceTimer = async (waitTime)=>await new Promise((resolve)=>setTimeout(resolve, waitTime));
+class $0d71b4e9cc4df40a$export$1f44aaf2ec115b54 {
+    createTester(patternName, opts) {
+        return new $0d71b4e9cc4df40a$var$keyToUtil[patternName]({
+            user: this.user,
+            interactionType: this.interactionType,
+            advanceTimer: this.advanceTimer,
+            ...opts
+        });
+    }
+    constructor(opts = {}){
+        let { interactionType: interactionType, advanceTimer: advanceTimer } = opts;
+        this.user = (0, $gmkhN$testinglibraryuserevent).setup({
+            delay: null,
+            pointerMap: $50ecfb18069ec897$export$7dbde2c4caaa8d35
+        });
+        this.interactionType = interactionType;
+        this.advanceTimer = advanceTimer || $0d71b4e9cc4df40a$var$defaultAdvanceTimer;
+    }
+}
+
+
+export {$0d71b4e9cc4df40a$export$1f44aaf2ec115b54 as User};
+//# sourceMappingURL=user.module.js.map

package/dist/user.module.js

@@ -0,0 +1,56 @@
+import {ComboBoxTester as $dab75f394483aa9c$export$f97e14e96d71ab3b} from "./combobox.module.js";
+import {GridListTester as $5ca9e9228f508f75$export$93a85aaed9fabd83} from "./gridlist.module.js";
+import {MenuTester as $74b93f0617179929$export$f73bbc9212ed861e} from "./menu.module.js";
+import {pointerMap as $50ecfb18069ec897$export$7dbde2c4caaa8d35} from "./userEventMaps.module.js";
+import {SelectTester as $4350df3e19e40e36$export$d1859707465446a9} from "./select.module.js";
+import {TableTester as $6d1e4cf220920c37$export$4c6a9d6ae3b0086} from "./table.module.js";
+import $gmkhN$testinglibraryuserevent from "@testing-library/user-event";
+
+/*
+ * 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.
+ */ 
+
+
+
+
+
+
+let $0d71b4e9cc4df40a$var$keyToUtil = {
+    'Select': (0, $4350df3e19e40e36$export$d1859707465446a9),
+    'Table': (0, $6d1e4cf220920c37$export$4c6a9d6ae3b0086),
+    'Menu': (0, $74b93f0617179929$export$f73bbc9212ed861e),
+    'ComboBox': (0, $dab75f394483aa9c$export$f97e14e96d71ab3b),
+    'GridList': (0, $5ca9e9228f508f75$export$93a85aaed9fabd83)
+};
+let $0d71b4e9cc4df40a$var$defaultAdvanceTimer = async (waitTime)=>await new Promise((resolve)=>setTimeout(resolve, waitTime));
+class $0d71b4e9cc4df40a$export$1f44aaf2ec115b54 {
+    createTester(patternName, opts) {
+        return new $0d71b4e9cc4df40a$var$keyToUtil[patternName]({
+            user: this.user,
+            interactionType: this.interactionType,
+            advanceTimer: this.advanceTimer,
+            ...opts
+        });
+    }
+    constructor(opts = {}){
+        let { interactionType: interactionType, advanceTimer: advanceTimer } = opts;
+        this.user = (0, $gmkhN$testinglibraryuserevent).setup({
+            delay: null,
+            pointerMap: $50ecfb18069ec897$export$7dbde2c4caaa8d35
+        });
+        this.interactionType = interactionType;
+        this.advanceTimer = advanceTimer || $0d71b4e9cc4df40a$var$defaultAdvanceTimer;
+    }
+}
+
+
+export {$0d71b4e9cc4df40a$export$1f44aaf2ec115b54 as User};
+//# sourceMappingURL=user.module.js.map

package/dist/user.module.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;AAAA;;;;;;;;;;CAUC;;;;;;;AAyBD,IAAI,kCAAY;IAAC,UAAU,CAAA,GAAA,yCAAW;IAAG,SAAS,CAAA,GAAA,wCAAU;IAAG,QAAQ,CAAA,GAAA,yCAAS;IAAG,YAAY,CAAA,GAAA,yCAAa;IAAG,YAAY,CAAA,GAAA,yCAAa;AAAC;AAoBzI,IAAI,4CAAsB,OAAO,WAAiC,MAAM,IAAI,QAAQ,CAAC,UAAY,WAAW,SAAS;AAE9G,MAAM;IAYX,aAAqC,WAAc,EAAE,IAA2B,EAAiB;QAC/F,OAAO,IAAI,AAAC,+BAAU,CAAC,YAAY,CAAC;YAAC,MAAM,IAAI,CAAC,IAAI;YAAE,iBAAiB,IAAI,CAAC,eAAe;YAAE,cAAc,IAAI,CAAC,YAAY;YAAE,GAAG,IAAI;QAAA;IACvI;IATA,YAAY,OAAiB,CAAC,CAAC,CAAE;QAC/B,IAAI,mBAAC,eAAe,gBAAE,YAAY,EAAC,GAAG;QACtC,IAAI,CAAC,IAAI,GAAG,CAAA,GAAA,8BAAQ,EAAE,KAAK,CAAC;YAAC,OAAO;wBAAM;QAAU;QACpD,IAAI,CAAC,eAAe,GAAG;QACvB,IAAI,CAAC,YAAY,GAAG,gBAAgB;IACtC;AAKF","sources":["packages/@react-aria/test-utils/src/user.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 {ComboBoxOptions, ComboBoxTester} from './combobox';\nimport {GridListOptions, GridListTester} from './gridlist';\nimport {MenuOptions, MenuTester} from './menu';\nimport {pointerMap} from './';\nimport {SelectOptions, SelectTester} from './select';\nimport {TableOptions, TableTester} from './table';\nimport userEvent from '@testing-library/user-event';\n\n// https://github.com/testing-library/dom-testing-library/issues/939#issuecomment-830771708 is an interesting way of allowing users to configure the timers\n// curent way is like https://testing-library.com/docs/user-event/options/#advancetimers,\nexport interface UserOpts {\n  interactionType?: 'mouse' | 'touch' | 'keyboard',\n  // If using fake timers user should provide something like (time) => jest.advanceTimersByTime(time))}\n  // A real timer user would pass async () => await new Promise((resolve) => setTimeout(resolve, waitTime))\n  // Time is in ms.\n  advanceTimer?: (time?: number) => void | Promise<unknown>\n}\n\nexport interface BaseTesterOpts {\n  // The base element for the given tester (e.g. the table, menu trigger, etc)\n  root: HTMLElement\n}\n\nlet keyToUtil = {'Select': SelectTester, 'Table': TableTester, 'Menu': MenuTester, 'ComboBox': ComboBoxTester, 'GridList': GridListTester} as const;\nexport type PatternNames = keyof typeof keyToUtil;\n\n// Conditional type: https://www.typescriptlang.org/docs/handbook/2/conditional-types.html\ntype ObjectType<T> =\n    T extends 'Select' ? SelectTester :\n    T extends 'Table' ? TableTester :\n    T extends 'Menu' ? MenuTester :\n    T extends 'ComboBox' ? ComboBoxTester :\n    T extends 'GridList' ? GridListTester :\n    never;\n\ntype ObjectOptionsTypes<T> =\n  T extends 'Select' ? SelectOptions :\n  T extends 'Table' ? TableOptions :\n  T extends 'Menu' ? MenuOptions :\n  T extends 'ComboBox' ? ComboBoxOptions :\n  T extends 'GridList' ? GridListOptions :\n  never;\n\nlet defaultAdvanceTimer = async (waitTime: number | undefined) => await new Promise((resolve) => setTimeout(resolve, waitTime));\n\nexport class User {\n  user;\n  interactionType: UserOpts['interactionType'];\n  advanceTimer: UserOpts['advanceTimer'];\n\n  constructor(opts: UserOpts = {}) {\n    let {interactionType, advanceTimer} = opts;\n    this.user = userEvent.setup({delay: null, pointerMap});\n    this.interactionType = interactionType;\n    this.advanceTimer = advanceTimer || defaultAdvanceTimer;\n  }\n\n  createTester<T extends PatternNames>(patternName: T, opts: ObjectOptionsTypes<T>): ObjectType<T> {\n    return new (keyToUtil)[patternName]({user: this.user, interactionType: this.interactionType, advanceTimer: this.advanceTimer, ...opts}) as ObjectType<T>;\n  }\n}\n"],"names":[],"version":3,"file":"user.module.js.map"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-aria/test-utils",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "Testing utils for react-aria patterns",
   "license": "Apache-2.0",
   "main": "dist/main.js",
@@ -25,13 +25,13 @@
     "@swc/helpers": "^0.5.0"
   },
   "peerDependencies": {
-    "@testing-library/react": "^13.0.0 || ^14.0.0",
+    "@testing-library/react": "^15.0.7",
     "@testing-library/user-event": "^13.0.0 || ^14.0.0",
-    "jest": "^27.0.0",
-    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0"
+    "jest": "^29.5.0",
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "b77d7d594dff4dcfb5359bffbcfd18142b146433"
+  "gitHead": "71f0ef23053f9e03ee7e97df736e8b083e006849"
 }

package/src/combobox.ts

@@ -0,0 +1,188 @@
+/*
+ * 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.
+ */
+
+import {act, waitFor, within} from '@testing-library/react';
+import {BaseTesterOpts, UserOpts} from './user';
+
+export interface ComboBoxOptions extends UserOpts, BaseTesterOpts {
+  user?: any,
+  trigger?: HTMLElement
+}
+
+export class ComboBoxTester {
+  private user;
+  private _interactionType: UserOpts['interactionType'];
+  private _combobox: HTMLElement;
+  private _trigger: HTMLElement | undefined;
+
+  constructor(opts: ComboBoxOptions) {
+    let {root, trigger, user, interactionType} = opts;
+    this.user = user;
+    this._interactionType = interactionType || 'mouse';
+
+    // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to
+    // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis
+    this._combobox = root;
+    let combobox = within(root).queryByRole('combobox');
+    if (combobox) {
+      this._combobox = combobox;
+    }
+
+    // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)
+    if (trigger) {
+      this._trigger = trigger;
+    } else {
+      let trigger = within(root).queryByRole('button', {hidden: true});
+      if (trigger) {
+        this._trigger = trigger;
+      } else {
+        // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox
+        // is also the trigger button
+        this._trigger = this._combobox;
+      }
+    }
+  }
+
+  setInteractionType = (type: UserOpts['interactionType']) => {
+    this._interactionType = type;
+  };
+
+  open = async (opts: {triggerBehavior?: 'focus' | 'manual', interactionType?: UserOpts['interactionType']} = {}) => {
+    let {triggerBehavior = 'manual', interactionType = this._interactionType} = opts;
+    let trigger = this.trigger;
+    let combobox = this.combobox;
+    let isDisabled = trigger!.hasAttribute('disabled');
+
+    if (interactionType === 'mouse') {
+      if (triggerBehavior === 'focus') {
+        await this.user.click(combobox);
+      } else {
+        await this.user.click(trigger);
+      }
+    } else if (interactionType === 'keyboard' && this._trigger != null) {
+      act(() => this._trigger!.focus());
+      if (triggerBehavior !== 'focus') {
+        await this.user.keyboard('{ArrowDown}');
+      }
+    } else if (interactionType === 'touch') {
+      if (triggerBehavior === 'focus') {
+        await this.user.pointer({target: combobox, keys: '[TouchA]'});
+      } else {
+        await this.user.pointer({target: trigger, keys: '[TouchA]'});
+      }
+    }
+
+    await waitFor(() => {
+      if (!isDisabled && combobox.getAttribute('aria-controls') == null) {
+        throw new Error('No aria-controls found on combobox trigger element.');
+      } else {
+        return true;
+      }
+    });
+    let listBoxId = combobox.getAttribute('aria-controls');
+    await waitFor(() => {
+      if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) {
+        throw new Error(`Listbox with id of ${listBoxId} not found in document.`);
+      } else {
+        return true;
+      }
+    });
+  };
+
+  selectOption = async (opts: {option?: HTMLElement, optionText?: string, triggerBehavior?: 'focus' | 'manual', interactionType?: UserOpts['interactionType']} = {}) => {
+    let {optionText, option, triggerBehavior, interactionType = this._interactionType} = opts;
+    if (!this.combobox.getAttribute('aria-controls')) {
+      await this.open({triggerBehavior});
+    }
+
+    let listbox = this.listbox;
+    if (listbox) {
+      if (!option && optionText) {
+        option = within(listbox).getByText(optionText);
+      }
+
+      // TODO: keyboard method of selecting the the option is a bit tricky unless I simply simulate the user pressing the down arrow
+      // the required amount of times to reach the option. For now just click the option even in keyboard mode
+      if (interactionType === 'mouse' || interactionType === 'keyboard') {
+        await this.user.click(option);
+      } else {
+        await this.user.pointer({target: option, keys: '[TouchA]'});
+      }
+
+      if (option && option.getAttribute('href') == null) {
+        await waitFor(() => {
+          if (document.contains(listbox)) {
+            throw new Error('Expected listbox element to not be in the document after selecting an option');
+          } else {
+            return true;
+          }
+        });
+      }
+    } else {
+      throw new Error("Attempted to select a option in the combobox, but the listbox wasn't found.");
+    }
+  };
+
+  close = async () => {
+    let listbox = this.listbox;
+    if (listbox) {
+      act(() => this.combobox.focus());
+      await this.user.keyboard('[Escape]');
+
+      await waitFor(() => {
+        if (document.contains(listbox)) {
+          throw new Error('Expected listbox element to not be in the document after selecting an option');
+        } else {
+          return true;
+        }
+      });
+    }
+  };
+
+  get combobox() {
+    return this._combobox;
+  }
+
+  get trigger() {
+    return this._trigger;
+  }
+
+  get listbox() {
+    let listBoxId = this.combobox.getAttribute('aria-controls');
+    return listBoxId ? document.getElementById(listBoxId) || undefined : undefined;
+  }
+
+  options = (opts: {element?: HTMLElement} = {}): HTMLElement[] | never[] => {
+    let {element} = opts;
+    element = element || this.listbox;
+    let options = [];
+    if (element) {
+      options = within(element).queryAllByRole('option');
+    }
+
+    return options;
+  };
+
+  get sections() {
+    let listbox = this.listbox;
+    if (listbox) {
+      return within(listbox).queryAllByRole('group');
+    } else {
+      return [];
+    }
+  }
+
+  get focusedOption() {
+    let focusedOptionId = this.combobox.getAttribute('aria-activedescendant');
+    return focusedOptionId ? document.getElementById(focusedOptionId) : undefined;
+  }
+}