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

package/dist/tree.module.js.map

@@ -1 +0,0 @@
-{"mappings":"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","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 {getAltKey, getMetaKey, 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']): void {\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, selectionOnNav?: 'default' | 'none'}) {\n    let {row, selectionOnNav = 'default'} = opts;\n    let altKey = getAltKey();\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\n    if (document.activeElement !== this._tree && !this._tree.contains(document.activeElement)) {\n      act(() => this._tree.focus());\n    }\n\n    if (document.activeElement === this.tree) {\n      await this.user.keyboard(`${selectionOnNav === 'none' ? `[${altKey}>]` : ''}[ArrowDown]${selectionOnNav === 'none' ? `[/${altKey}]` : ''}`);\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    if (selectionOnNav === 'none') {\n      await this.user.keyboard(`[${altKey}>]`);\n    }\n    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {\n      await this.user.keyboard(`[${direction === 'down' ? 'ArrowDown' : 'ArrowUp'}]`);\n    }\n    if (selectionOnNav === 'none') {\n      await this.user.keyboard(`[/${altKey}]`);\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   * Note that this will endevor to always add/remove JUST the provided row to the set of selected rows.\n   */\n  async toggleRowSelection(opts: TreeToggleRowOpts): Promise<void> {\n    let {\n      row,\n      needsLongPress,\n      checkboxSelection = true,\n      interactionType = this._interactionType,\n      selectionBehavior = 'toggle'\n    } = opts;\n\n    let altKey = getAltKey();\n    let metaKey = getMetaKey();\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 || !rowCheckbox)) {\n      await this.keyboardNavigateToRow({row, selectionOnNav: selectionBehavior === 'replace' ? 'none' : 'default'});\n      if (selectionBehavior === 'replace') {\n        await this.user.keyboard(`[${altKey}>]`);\n      }\n      await this.user.keyboard('[Space]');\n      if (selectionBehavior === 'replace') {\n        await this.user.keyboard(`[/${altKey}]`);\n      }\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        // TODO add modifiers here? Maybe move into pressElement if we get more cases for different types of modifier keys\n        if (selectionBehavior === 'replace' && interactionType !== 'touch') {\n          await this.user.keyboard(`[${metaKey}>]`);\n        }\n        await pressElement(this.user, row, interactionType);\n        if (selectionBehavior === 'replace' && interactionType !== 'touch') {\n          await this.user.keyboard(`[/${metaKey}]`);\n        }\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): Promise<void> {\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      // TODO: We always Use Option/Ctrl when keyboard navigating so selection isn't changed\n      // in selectionmode=\"replace\"/highlight selection when navigating to the row that the user wants\n      // to expand. Discuss if this is useful or not\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): Promise<void> {\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      // TODO: same as above, uses the modifier key to make sure we don't modify selection state on row focus\n      // as we keyboard navigate to the row we want activate\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.module.js.map"}